CorebanqCorebanq Developer Docs
Transfersv1Transfers

List transfers

List transfers with filtering, sorting, and pagination support. Uses RBAC-aware query system with JSON-based search and sort parameters.

GET/v1/transfers

Authorization

BearerAuth
AuthorizationBearer <token>

JWT authentication token

In: header

Query Parameters

search.status?string

Filter by transfer status

search.type?string

Filter by transfer type

search.ori_customer_id?string

Filter by originator customer ID (UUID)

search.ben_customer_id?string

Filter by beneficiary customer ID (UUID)

search.customer_id?string

Deprecated: Use search.ori_customer_id instead. Filter by originator customer ID (UUID)

search.product_id?string

Filter by product ID (UUID)

search.product_code?string

Filter by product code (alternative to product_id). If product code is not found, returns no results.

search.txn_ccy?string

Filter by currency code (txn_ccy)

sort?string

Sort field (prefix with - for descending). Example: -created_at or created_at

limit?integer

Number of items per page

offset?integer

Starting position for pagination

Header Parameters

Accept-Language?string

Language preference for the response

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/transfers"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "product_id": "0d012afa-f885-4e65-aeca-37e27701e2d1",
      "product_code": "CRD",
      "ori_customer_id": "bc70e6eb-7d69-4074-a870-6cf369440f5d",
      "ben_customer_id": "f5b93205-a0f3-4d6a-a411-580dff187bdf",
      "ori_account_id": "93f2cf79-32f9-44a2-ad78-373f29b5514e",
      "ben_account_id": "4d1f2312-f55e-46c1-af1c-97fa399de1d5",
      "type": "crypto_withdrawal",
      "status": "draft",
      "txn_amt": 0,
      "txn_ccy": "string",
      "txn_paymentPurpose": "string",
      "ori_name": "string",
      "ori_iban": "string",
      "ori_bic": "string",
      "ben_name": "string",
      "ben_iban": "string",
      "ben_bic": "string",
      "ben_amt": 0,
      "ben_ccy": "string",
      "ori_walletAddress": "string",
      "ben_walletAddress": "string",
      "ben_addressTag": "string",
      "bc_network": "string",
      "bc_txHash": "string",
      "token": "string",
      "txn_netAmt": 0,
      "txn_feeAmt": 0,
      "txn_instructionId": "string",
      "txn_externalId": "string",
      "direction": "string",
      "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef",
      "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992",
      "metadata": {},
      "context": {},
      "error_code": "string",
      "error_message": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "total": 0,
  "total_unfiltered": 0,
  "has_more": true
}
{
  "status": 0,
  "message": "string"
}
{
  "status": 0,
  "message": "string"
}