> ## Documentation Index
> Fetch the complete documentation index at: https://developer.embedly.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all split beneficiaries

> Retrieves all split beneficiaries for the authenticated organization with optional filters for active status and search term. Supports pagination. Organization API key required.

**organizationId** `string` *required*

The unique organizationId. Example: `3fa85f64-5717-4562-b3fc-2c963f66afa6`

**page** `string` (default: 1)

**pageSize** `string` (default: 10)

**isActive** `boolean`

**searchTerm** `string`

```json 200 Success theme={null}
{
"statusCode": 200,
"message": "Beneficiaries retrieved successfully",
"data": {
  "beneficiaries": [
    {
      "id": "6b6e94a9-c795-4c22-a94a-bc3fce632cc9",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "string",
      "accountNumber": "4278816936",
      "bankCode": "string",
      "bankName": "string",
      "beneficiaryAlias": "string",
      "isActive": true,
      "createdAt": "2026-02-16T07:59:45.982564Z",
      "updatedAt": "2026-02-16T08:01:42.358107Z"
    },
    {
      "id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "string",
      "accountNumber": "4278816938",
      "bankCode": "string",
      "bankName": "string",
      "beneficiaryAlias": "string",
      "isActive": true,
      "createdAt": "2026-02-16T07:57:04.468813Z",
      "updatedAt": null
    },
    {
      "id": "97c576be-7953-4b58-8699-2b0cd2265857",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "John Doe",
      "accountNumber": "2345667880",
      "bankCode": "000007",
      "bankName": "Fidelity Bank",
      "beneficiaryAlias": "testing",
      "isActive": true,
      "createdAt": "2026-01-28T08:20:13.899217Z",
      "updatedAt": null
    },
    {
      "id": "0c11927f-f4a3-4c0b-b712-db457375ad43",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "John Doe",
      "accountNumber": "0108834787",
      "bankCode": "000009",
      "bankName": "Citi Bank",
      "beneficiaryAlias": "testing",
      "isActive": true,
      "createdAt": "2026-01-23T16:10:55.768738Z",
      "updatedAt": null
    },
    {
      "id": "6978ba2c-b7dd-4d7c-aca2-293695637977",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "John Doe",
      "accountNumber": "2345667887",
      "bankCode": "000013",
      "bankName": "GTBank Plc",
      "beneficiaryAlias": "pop",
      "isActive": true,
      "createdAt": "2026-01-21T08:43:30.223918Z",
      "updatedAt": null
    },
    {
      "id": "8ccbefcb-f90b-431b-bec6-c35b0ca96daf",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "John Doe",
      "accountNumber": "2345667881",
      "bankCode": "090108",
      "bankName": "New Prudential Bank",
      "beneficiaryAlias": "New",
      "isActive": true,
      "createdAt": "2026-01-20T08:06:48.919992Z",
      "updatedAt": null
    },
    {
      "id": "0dc6566a-dc10-4cd4-945a-620c71ef3d11",
      "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
      "beneficiaryName": "John Doe",
      "accountNumber": "0000000000",
      "bankCode": "000009",
      "bankName": null,
      "beneficiaryAlias": "John Doe",
      "isActive": true,
      "createdAt": "2026-01-19T17:36:38.598417Z",
      "updatedAt": "2026-01-21T17:06:32.333421Z"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "totalCount": 15,
  "totalPages": 1
}
}
```

```json 401 Unauthorized theme={null}
{
  "code": "401",
  "success": false,
  "message": "x-api-key is missing in the header",
  "data": null
}
```

```json 403 Forbidden theme={null}
{
  "statusCode": 403,
  "message": "Access denied. The API key provided is for another organization. You can only access your organization's wallets.",
  "data": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.