# List beneficiaries

Lists the beneficiaries of this payment account, newest first. This list takes `page` and `per_page`. It has no status filter, so filter on `status` in your app.

Endpoint: GET /payment-accounts/{payment_account_id}/beneficiaries
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Path parameters:

  - `payment_account_id` (string, required)
    The ID of a payment account you own. Starts with `pacct_`.

## Query parameters:

  - `page` (integer)
    Page number for pagination. Starts from 1. Get the next page number from the `next` field in the response.

  - `per_page` (integer)
    Number of resources per page. Should be between 1 and 100.

## Response 200:

  - `200` (unknown)
    Beneficiaries

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Example: bene_6ab5a1c9gflRf

  - `data.payment_account_id` (string)
    The payment account that owns the beneficiary.
    Example: pacct_6ab59a10Hk3Zq

  - `data.name` (string)
    Example: Aarav Nair

  - `data.category` (string)
    Enum: "payout"

  - `data.type` (string)
    Enum: "individual", "business"

  - `data.email` (string | null)
    Example: aarav.nair@example.com

  - `data.phone` (string | null)
    Example: null

  - `data.nickname` (string | null)
    Example: My NRE account

  - `data.status` (string)
    `active` beneficiaries can receive payouts. A payout to a `pending` or `rejected` beneficiary returns `400`.
    Enum: "active", "pending", "rejected"

  - `data.notes` (object | null)
    Example: null

  - `data.address` (object | null)

  - `data.address.address_line1` (string)
    Example: 12 Marina Walk

  - `data.address.address_line2` (string | null)
    Example: null

  - `data.address.city` (string)
    Example: Kochi

  - `data.address.state` (string)
    Example: Kerala

  - `data.address.country_code` (string)
    ISO 3166-1 alpha-3 country code.
    Example: IND

  - `data.address.postal_code` (string | null)
    Example: 682001

  - `data.bank_account` (object | null)
    The bank account details. `null` on a UPI beneficiary.

  - `data.bank_account.account_number` (string)
    Example: 000111222333

  - `data.bank_account.name` (string | null)
    The name of the bank.
    Example: HDFC Bank

  - `data.bank_account.swift_code` (string | null)
    Example: null

  - `data.bank_account.local_routing_number` (string | null)
    The local routing code, for example the IFSC for an INR account.
    Example: HDFC0000123

  - `data.bank_account.currency` (string)
    Example: INR

  - `data.bank_account.category` (string | null)
    Example: null

  - `data.bank_account.intermediate_bank` (object | null)
    Example: null

  - `data.bank_account.intermediate_bank.name` (string)

  - `data.bank_account.intermediate_bank.country` (string)

  - `data.bank_account.intermediate_bank.swift_code` (string)

  - `data.bank_account.intermediate_bank.account_number` (string)

  - `data.upi_account` (object | null)
    The UPI details. `null` on a bank account beneficiary.
    Example: null

  - `data.upi_account.upi_id` (string)
    Example: aarav@okhdfcbank

  - `data.created_at` (string)
    Example: 2026-10-15T10:40:12Z

  - `data.updated_at` (string)
    Example: 2026-10-15T10:40:12Z

  - `page_meta` (object)

  - `page_meta.current` (integer)
    The current page number.
    Example: 2

  - `page_meta.previous` (integer | null)
    The previous page number.
    Example: 1

  - `page_meta.next` (integer | null)
    The next page number.
    Example: 3

  - `page_meta.per_page` (integer)
    The number of items per page.
    Example: 20

  - `page_meta.pages` (integer)
    The total number of pages.
    Example: 10

  - `page_meta.count` (integer)
    The total number of items.
    Example: 200

## Response 404:

  - `404` (unknown)
    The payment account does not exist or you do not own it

## Response 404 fields (application/json):

  - `error` (string, required)
    The HTTP reason phrase.
    Example: Bad Request

  - `message` (string, required)
    What went wrong. Show it in logs, not to the customer.
    Example: Payment account cannot send money

  - `code` (string)
    A stable code for the error. Present only on some errors, for example `INSUFFICIENT_BALANCE` on a payout and `order_amount_above_cap` on an order. Branch on `code` when it is present, and on the HTTP status when it is not.
    Example: INSUFFICIENT_BALANCE

