List balance transfers
curl --request GET \
--url https://api.daya.co/v1/merchant/balance/transfers \
--header 'X-Api-Key: <x-api-key>'import requests
url = "https://api.daya.co/v1/merchant/balance/transfers"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://api.daya.co/v1/merchant/balance/transfers', 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.daya.co/v1/merchant/balance/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <x-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.daya.co/v1/merchant/balance/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<x-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.daya.co/v1/merchant/balance/transfers")
.header("X-Api-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/merchant/balance/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"amount_usd": "100.0000",
"status": "COMPLETED",
"collection_balance_before_usd": "500.0000",
"collection_balance_after_usd": "400.0000",
"withdrawal_balance_before_usd": "200.0000",
"withdrawal_balance_after_usd": "300.0000",
"failure_message": null,
"created_at": "2026-01-05T15:04:05Z",
"updated_at": "2026-01-05T15:04:05Z"
}
],
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1
}
Merchant Balance
List balance transfers
List collection-to-withdrawal balance transfer history
GET
/
v1
/
merchant
/
balance
/
transfers
List balance transfers
curl --request GET \
--url https://api.daya.co/v1/merchant/balance/transfers \
--header 'X-Api-Key: <x-api-key>'import requests
url = "https://api.daya.co/v1/merchant/balance/transfers"
headers = {"X-Api-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};
fetch('https://api.daya.co/v1/merchant/balance/transfers', 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.daya.co/v1/merchant/balance/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <x-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.daya.co/v1/merchant/balance/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<x-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.daya.co/v1/merchant/balance/transfers")
.header("X-Api-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.daya.co/v1/merchant/balance/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"amount_usd": "100.0000",
"status": "COMPLETED",
"collection_balance_before_usd": "500.0000",
"collection_balance_after_usd": "400.0000",
"withdrawal_balance_before_usd": "200.0000",
"withdrawal_balance_after_usd": "300.0000",
"failure_message": null,
"created_at": "2026-01-05T15:04:05Z",
"updated_at": "2026-01-05T15:04:05Z"
}
],
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1
}
Overview
Lists the history of collection-to-withdrawal balance transfers for the authenticated merchant. This is the audit trail for balance moves executed viaPOST /v1/merchant/balance/transfer.
This endpoint returns the history of balance moves. To execute a new balance transfer, use
POST /v1/merchant/balance/transfer, which returns the updated balances immediately.Authentication
string
required
Your merchant API key
Query Parameters
integer
Number of results per page (default: 50)
integer
Page number (default: 1)
string
Filter by transfer statusAllowed values:
PENDING | COMPLETED | FAILEDRequest Example
curl --request GET \
--url 'https://api.daya.co/v1/merchant/balance/transfers?limit=50&page=1' \
--header 'X-Api-Key: YOUR_API_KEY'
Response
array
required
Array of balance transfer records.
Show balance transfer properties
Show balance transfer properties
string
Unique transfer identifier (UUID)
string
Amount transferred in USD
string
Transfer status:
PENDING, COMPLETED, or FAILEDstring
Collection balance before the transfer
string
Collection balance after the transfer
string
Withdrawal balance before the transfer
string
Withdrawal balance after the transfer
string
Human-readable failure detail (present when status is
FAILED)string
When the transfer was created (ISO 8601)
string
When the transfer was last updated (ISO 8601)
integer
required
Current page number
integer
required
Results per page
integer
required
Total number of balance transfers
integer
required
Total number of pages
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"amount_usd": "100.0000",
"status": "COMPLETED",
"collection_balance_before_usd": "500.0000",
"collection_balance_after_usd": "400.0000",
"withdrawal_balance_before_usd": "200.0000",
"withdrawal_balance_after_usd": "300.0000",
"failure_message": null,
"created_at": "2026-01-05T15:04:05Z",
"updated_at": "2026-01-05T15:04:05Z"
}
],
"page": 1,
"limit": 50,
"total": 1,
"total_pages": 1
}