Actions19
Beneficiary → List
AI-generatedOverview
This node operation lists beneficiaries, allowing users to retrieve a paginated list of beneficiary records. It supports filtering by currency and pagination controls such as page number and records per page. This is useful for scenarios where users need to manage or review their beneficiaries in a currency transfer system, for example, to display beneficiaries in a user interface or to process payments to selected beneficiaries.
Use Case Examples
- Retrieve the first page of beneficiaries with default 25 records per page.
- List beneficiaries filtered by specific currencies to narrow down the results.
Properties
| Name | Meaning |
|---|---|
| Page | Page number to retrieve in the paginated list of beneficiaries. |
| Per Page | Number of beneficiary records to retrieve per page. |
| Currency Filter | Filter the list of beneficiaries by selected currencies. |
Output
JSON
beneficiaries- Array of beneficiary records returned from the list operation.paginationpage- Current page number of the results.perPage- Number of records per page in the results.totalPages- Total number of pages available.totalRecords- Total number of beneficiary records available.
Dependencies
- An API key credential for authentication to the currency transfer API.
Troubleshooting
- Common issues include invalid page numbers or per page values causing empty or error responses. Ensure page and per page inputs are valid positive integers.
- Filtering by unsupported or invalid currencies may result in no data returned.
- Timeouts or SSL certificate issues can occur; use the request options to adjust timeout or allow insecure certificates if necessary.