curl --request GET \
--url https://api.fintoc.com/v2/transfer_batches/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/transfer_batches/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/transfer_batches/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/transfer_batches/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/transfer_batches/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/transfer_batches/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/transfer_batches/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "transfer_batch",
"amount": 150000,
"authorized_at": "2026-03-01T12:05:00Z",
"created_at": "2026-03-01T12:00:00Z",
"currency": "MXN",
"description": "Supplier payouts March",
"expired_at": null,
"mode": "test",
"partially_succeeded_at": null,
"rejected_at": null,
"settled_amount": 0,
"status": "in_progress",
"succeeded_at": null,
"succeeded_count": 0,
"transfer_count": 3
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"code": "missing_resource",
"message": "TransferBatch not found: trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"code": "operation_not_implemented",
"message": "Operation not implemented for this region"
}
}Get a transfer batch
Gets a transfer batch for your organization by ID. A batch in in_progress was approved from the Dashboard and its transfers are being sent. To read the transfers of the batch, call GET /v2/transfers with the transfer_batch_id query parameter.
curl --request GET \
--url https://api.fintoc.com/v2/transfer_batches/{id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/transfer_batches/{id}"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/transfer_batches/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/transfer_batches/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/transfer_batches/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/transfer_batches/{id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/transfer_batches/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "transfer_batch",
"amount": 150000,
"authorized_at": "2026-03-01T12:05:00Z",
"created_at": "2026-03-01T12:00:00Z",
"currency": "MXN",
"description": "Supplier payouts March",
"expired_at": null,
"mode": "test",
"partially_succeeded_at": null,
"rejected_at": null,
"settled_amount": 0,
"status": "in_progress",
"succeeded_at": null,
"succeeded_count": 0,
"transfer_count": 3
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}{
"error": {
"code": "missing_resource",
"message": "TransferBatch not found: trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
}{
"error": {
"code": "operation_not_implemented",
"message": "Operation not implemented for this region"
}
}Autorizaciones
Parámetros de ruta
Unique identifier of the transfer batch to retrieve.
Respuesta
The requested transfer batch.
A group of outbound transfers that you create in one request and approve once from the Dashboard. Fintoc sends the transfers in the batch after you approve the batch. List them with GET /v2/transfers and the transfer_batch_id query parameter.
Unique identifier of the transfer batch.
"trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always transfer_batch.
Sum of the amounts of the transfers in the batch, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.
150000
Time the batch was approved from the Dashboard, as an ISO 8601 datetime in UTC, or null.
"2026-03-01T12:05:00Z"
Time the batch was created, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00Z"
Currency of the transfers in the batch. One of CLP, MXN.
CLP, MXN "MXN"
Human-readable label for the batch. Up to 40 characters.
"Supplier payouts March"
Time the batch expired without approval, as an ISO 8601 datetime in UTC, or null.
null
Whether the batch is live or test data.
live, test "test"
Time the batch finished after only some transfers succeeded, as an ISO 8601 datetime in UTC, or null.
null
Time the batch was rejected from the Dashboard, as an ISO 8601 datetime in UTC, or null.
null
Sum of the settled_amount of the transfers in the batch, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.
0
Lifecycle status of the batch. One of pending_authorization (waiting for approval in the Dashboard), rejected (rejected in the Dashboard), expired (not approved in time), in_progress (approved, with transfers being sent), succeeded (every transfer succeeded), partially_succeeded (some transfers succeeded), or failed (no transfer succeeded).
pending_authorization, rejected, expired, in_progress, succeeded, partially_succeeded, failed "in_progress"
Time every transfer of the batch succeeded, as an ISO 8601 datetime in UTC, or null.
null
Number of transfers in the batch that succeeded.
0
Number of transfers in the batch.
3
¿Esta página le ayudó?