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
}

GET

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 via POST /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

X-Api-Key

string

required

Your merchant API key

Query Parameters

limit

integer

Number of results per page (default: 50)

page

integer

Page number (default: 1)

status

string

Filter by transfer statusAllowed values: PENDING | COMPLETED | FAILED

Request 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

data

array

required

Array of balance transfer records.

Show balance transfer properties

data[].id

string

Unique transfer identifier (UUID)

data[].amount_usd

string

Amount transferred in USD

data[].status

string

Transfer status: PENDING, COMPLETED, or FAILED

data[].collection_balance_before_usd

string

Collection balance before the transfer

data[].collection_balance_after_usd

string

Collection balance after the transfer

data[].withdrawal_balance_before_usd

string

Withdrawal balance before the transfer

data[].withdrawal_balance_after_usd

string

Withdrawal balance after the transfer

data[].failure_message

string

Human-readable failure detail (present when status is FAILED)

data[].created_at

string

When the transfer was created (ISO 8601)

data[].updated_at

string

When the transfer was last updated (ISO 8601)

page

integer

required

Current page number

limit

integer

required

Results per page

total

integer

required

Total number of balance transfers

total_pages

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
}

Transfer merchant balance Withdraw merchant balance

Getting Started

Core Concepts

Guides

Rates & Chains

Customers

Funding Accounts

Transfers

Deposits

Recipients

Banks

USD Virtual Accounts

USD Virtual Account Deposits

Merchant Balance

Merchant Funding

Webhooks

Legacy API

List balance transfers

Overview

Authentication

Query Parameters

Request Example

Response

​Overview

​Authentication

​Query Parameters

​Request Example

​Response

Overview

Authentication

Query Parameters

Request Example

Response