List all beneficiaries

Retrieve a paginated list of all the beneficiaries on the merchant's profile.

Bank and inter-merchant beneficiary lists are retrieved separately.

List bank transfer beneficiaries

Retrieve a paginated list of bank transfer beneficiaries.

get

Authorizations

Query parameters

searchstringoptional

pageinteger · int32optional

page_sizeinteger · int32optional

show_shadow_deletedbooleanoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/beneficiaries/list-bank-beneficiaries' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "status": "success",
  "message": "text",
  "data": [
    {
      "id": "text",
      "beneficiary_type": "bankAccount",
      "currency": "text",
      "country": "text",
      "full_name": "text",
      "email": "text",
      "phone_number": "text",
      "description": "text",
      "account_number": "text",
      "account_name": "text",
      "bank_name": "text",
      "bank_code": "text",
      "created_at": "2025-04-03T10:24:44.244Z",
      "edited_at": "2025-04-03T10:24:44.244Z"
    }
  ],
  "meta": {
    "page_meta": {
      "page_count": 1,
      "item_count": 1,
      "search": "text",
      "page": 1,
      "page_size": 1
    }
  },
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}

Success

List inter-merchant disbursement beneficiaries

List gateway beneficiaries

get

Authorizations

Query parameters

searchstringoptional

pageinteger · int32optional

page_sizeinteger · int32optional

show_shadow_deletedbooleanoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/beneficiaries/list-gateway-beneficiaries' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "status": "success",
  "message": "text",
  "data": [
    {
      "id": "text",
      "beneficiary_type": "bankAccount",
      "currency": "text",
      "country": "text",
      "full_name": "text",
      "email": "text",
      "phone_number": "text",
      "description": "text",
      "merchant_id_or_code": "text",
      "merchant_name": "text",
      "gateway_name": "text",
      "recipient_gateway_code": "text",
      "created_at": "2025-04-03T10:24:44.244Z",
      "edited_at": "2025-04-03T10:24:44.244Z"
    }
  ],
  "meta": {
    "page_meta": {
      "page_count": 1,
      "item_count": 1,
      "search": "text",
      "page": 1,
      "page_size": 1
    }
  },
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}

Success