Retrieve a paginated list of beneficiaries associated with your account.
This endpoint supports filtering and sorting options to help you manage large numbers of beneficiaries efficiently.
Number of records to return per page (max: 100)
Cursor for fetching next page of results
Cursor for fetching previous page of results
Filter by currency (e.g., NGN, USD, CAD)
Filter by beneficiary type (e.g., bank_account, crypto_address)
Array of beneficiary objects
The API uses cursor-based pagination. To fetch subsequent pages:
Get the after
cursor from the pagination object
Include it in your next request
Repeat until no more after
cursor is returned
For optimal performance:
Use reasonable page sizes (15-50 records)
Cache results when possible
Implement progressive loading in your UI
400 Bad Request
401 Unauthorized
Efficient Filtering
Use filters to reduce response size
Combine filters for precise results
Cache frequently accessed data
Pagination Handling
Store cursors temporarily for navigation
Implement infinite scroll for large lists
Show loading states during fetches
Error Handling
Implement proper retry logic
Handle rate limits gracefully
Log pagination errors
For additional assistance:
Check our Error Handling Guide
Contact Support
Retrieve a paginated list of beneficiaries associated with your account.
This endpoint supports filtering and sorting options to help you manage large numbers of beneficiaries efficiently.
Number of records to return per page (max: 100)
Cursor for fetching next page of results
Cursor for fetching previous page of results
Filter by currency (e.g., NGN, USD, CAD)
Filter by beneficiary type (e.g., bank_account, crypto_address)
Array of beneficiary objects
The API uses cursor-based pagination. To fetch subsequent pages:
Get the after
cursor from the pagination object
Include it in your next request
Repeat until no more after
cursor is returned
For optimal performance:
Use reasonable page sizes (15-50 records)
Cache results when possible
Implement progressive loading in your UI
400 Bad Request
401 Unauthorized
Efficient Filtering
Use filters to reduce response size
Combine filters for precise results
Cache frequently accessed data
Pagination Handling
Store cursors temporarily for navigation
Implement infinite scroll for large lists
Show loading states during fetches
Error Handling
Implement proper retry logic
Handle rate limits gracefully
Log pagination errors
For additional assistance:
Check our Error Handling Guide
Contact Support