Easy Labs
APIPaymentsTransfer

Get transfers

Retrieve a list of transfers. Filters: `type` (DEBIT/CREDIT/REVERSAL/FEE), `subtype`, `parent_transfer`, `source`, `merchant` (override scoping; must be company-owned). `scope=company` widens scoping from the auth context's primary merchant to all the company's merchants. `expand` accepts comma-separated keys: merchant, merchant_identity, instrument, parent.

GET
/v1/api/transfer/
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Query Parameters

limit?number
Range0 <= value
offset?number
Range0 <= value
ids?string
type?string
Value in"DEBIT" | "CREDIT" | "REVERSAL" | "FEE" | "ADJUSTMENT" | "DISPUTE" | "RESERVE" | "SETTLEMENT" | "UNKNOWN"
subtype?string
Value in"API" | "APPLICATION_FEE" | "DISPUTE" | "MERCHANT_CREDIT" | "MERCHANT_CREDIT_ADJUSTMENT" | "MERCHANT_DEBIT" | "MERCHANT_DEBIT_ADJUSTMENT" | "PLATFORM_CREDIT" | "PLATFORM_CREDIT_ADJUSTMENT" | "PLATFORM_DEBIT" | "PLATFORM_DEBIT_ADJUSTMENT" | "PLATFORM_FEE" | "SETTLEMENT_MERCHANT" | "SETTLEMENT_NOOP" | "SETTLEMENT_PARTNER" | "SETTLEMENT_PLATFORM" | "SPLIT_PAYOUT" | "SPLIT_PAYOUT_ADJUSTMENT" | "SYSTEM"
parent_transfer?string
source?string
merchant?string
scope?string
Value in"merchant" | "company"
expand?string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/v1/api/transfer/"
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": [
    {
      "id": "TRxxxxxxxxxxxxxxxxxx",
      "amount": 5000,
      "currency": "USD",
      "state": "SUCCEEDED",
      "identity_id": "IDxxxxxxxxxxxxxxxxxx",
      "tags": {},
      "created_at": "2026-01-15T00:00:00.000Z"
    }
  ]
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}