List beneficiaries | CrissCross

curl https://api.crisscross.money/v1/beneficiaries \
     -H "Authorization: Bearer <token>"

{
  "beneficiaries": [
    {
      "beneficiaryId": "ben_f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "status": "active",
      "currency": "NGN",
      "name": "Acme Supplier Ltd",
      "entityType": "business",
      "accountDetails": [
        {
          "type": "account_number",
          "value": "1234567890"
        }
      ],
      "routingDetails": [
        {
          "rail": "fiat",
          "paymentType": "local",
          "routingNumber": "044",
          "routingNumberType": "other",
          "bank": {
            "name": "Access Bank",
            "address": "14/15 Prince Alaba Oniru Rd, Lagos"
          }
        }
      ],
      "createdAt": "2026-04-21T14:14:55Z",
      "address": {
        "line1": "100 Market Street",
        "city": "Lagos",
        "postcode": "100001",
        "country": "NG"
      },
      "activatedAt": "2026-04-21T14:20:00Z"
    },
    {
      "beneficiaryId": "ben_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "active",
      "currency": "USDT",
      "name": "Acme Supplier Ltd",
      "entityType": "business",
      "accountDetails": [
        {
          "type": "wallet_address",
          "value": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        }
      ],
      "routingDetails": [
        {
          "rail": "crypto",
          "network": "ethereum"
        }
      ],
      "createdAt": "2026-04-20T09:30:00Z",
      "address": {
        "line1": "100 Market Street",
        "city": "Lagos",
        "postcode": "100001",
        "country": "NG"
      },
      "activatedAt": "2026-04-20T09:35:00Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

Returns beneficiaries owned by the authenticated client, most recent first.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Query parameters

currencystringOptional

statuslist of enumsOptional

Filter by one or more statuses. Repeatable — e.g. ?status=pending&status=active.

Allowed values:

createdAfterdatetimeOptional

createdBeforedatetimeOptional

limitintegerOptional1-200Defaults to 20

Maximum number of results to return. Default 20, max 200.

cursorstringOptional

Opaque cursor from nextCursor of a previous response.

Response

Paginated list of beneficiaries.

beneficiarieslist of objects

nextCursorstring or null

Opaque cursor for the next page. null when the list is exhausted.

hasMoreboolean

Convenience flag. false when nextCursor is null.

Errors

400

Bad Request Error

401

Unauthorized Error