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

# List Payment Destinations

> List a beneficiary's payment destinations with pagination and filters

Returns a paginated list of payment destinations for a beneficiary, wrapped in the standard paginated envelope.

## Path Parameters

<ParamField path="account_id" type="string" required>
  Id of the parent account (e.g. `acct_...`).
</ParamField>

<ParamField path="beneficiary_id" type="string" required>
  Beneficiary id (e.g. `bene_…`).
</ParamField>

## Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number, starting at 1. Default 1.
</ParamField>

<ParamField query="size" type="integer" default="10">
  Items per page. Default 10.
</ParamField>

<ParamField query="statuses" type="array">
  Filter by status: `active`, `pending`, `disabled`.
</ParamField>

<ParamField query="start_date" type="datetime">
  Created-at lower bound (inclusive).
</ParamField>

<ParamField query="end_date" type="datetime">
  Created-at upper bound (exclusive).
</ParamField>

## Response

Returns 200 with a paginated list of payment destination objects. Account identifiers are always masked.

<ResponseField name="items" type="object[]">
  The payment destination objects on this page. Each item has the same masked shape as Get Payment Destination.
</ResponseField>

<ResponseField name="page" type="integer">
  Current page number.
</ResponseField>

<ResponseField name="size" type="integer">
  Items per page.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of items.
</ResponseField>

<ResponseField name="pages" type="integer">
  Total number of pages.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "items": [
      {
        "object": "payment_destination",
        "id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
        "beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
        "country": "GB",
        "payment_method": "wire",
        "type": "bank_account",
        "label": "Globex GBP",
        "currency": "GBP",
        "status": "active",
        "account_number_last4": "****6819",
        "iban_masked": "GB29****6819",
        "pix_key_masked": null,
        "is_default": true,
        "created": "2026-05-01T10:05:00Z",
        "updated": null
      }
    ],
    "page": 1,
    "size": 10,
    "total": 1,
    "pages": 1
  }
  ```
</ResponseExample>