> ## 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 Payments

> Retrieve a paginated list of payments for an account

Returns a paginated list of payments for the account, ordered newest first.

## Path Parameters

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

## Query Parameters

<ParamField query="page" type="int" default="1">
  Page number, ≥ 1. Default 1.
</ParamField>

<ParamField query="size" type="int" default="10">
  Items per page, 1–100. Default 10.
</ParamField>

<ParamField query="virtual_account_id" type="string | null">
  Filter by source virtual account id (`va_…`).
</ParamField>

<ParamField query="id" type="string | null">
  Filter by payment id (`apo_…`).
</ParamField>

<ParamField query="beneficiary_id" type="string | null">
  Filter by beneficiary id (`bene_…`).
</ParamField>

<ParamField query="payment_destination_id" type="string | null">
  Filter by payment destination id (`dest_…`).
</ParamField>

<ParamField query="status" type="enum | null">
  Filter by payment status: `pending_review`, `pending`, `processing`, `settled`, `failed`, `rejected`, `returned`.
</ParamField>

<ParamField query="currency" type="enum | null">
  Filter by payment currency.
</ParamField>

<ParamField query="start_date" type="datetime | null">
  Include payments created at or after this timestamp (inclusive).
</ParamField>

<ParamField query="end_date" type="datetime | null">
  Include payments created before this timestamp (exclusive).
</ParamField>

## Response

Returns a paginated list of payment summaries — a flatter shape than the detail object, without the nested `payment` and `beneficiary` blocks.

<ResponseField name="items" type="object[]">
  The payments on this page.

  <Expandable title="payment attributes">
    <ResponseField name="object" type="string">
      Always `payment`.
    </ResponseField>

    <ResponseField name="id" type="string">
      Payment id (`apo_…`).
    </ResponseField>

    <ResponseField name="type" type="string">
      Always `payment`.
    </ResponseField>

    <ResponseField name="note" type="string | null">
      Private note for your platform, from create.
    </ResponseField>

    <ResponseField name="reference" type="string | null">
      Bank-visible memo (SWIFT MT103 Field 70).
    </ResponseField>

    <ResponseField name="payment_purpose" type="enum | null">
      `PaymentPurpose` value from create.
    </ResponseField>

    <ResponseField name="beneficiary_id" type="string">
      Beneficiary id (`bene_…`).
    </ResponseField>

    <ResponseField name="beneficiary_name" type="string">
      Beneficiary display name.
    </ResponseField>

    <ResponseField name="source_account" type="string">
      Masked source virtual-account label.
    </ResponseField>

    <ResponseField name="destination_account" type="string">
      Masked destination account label.
    </ResponseField>

    <ResponseField name="currency" type="enum">
      Payment currency.
    </ResponseField>

    <ResponseField name="amount" type="decimal">
      Recipient amount in the destination currency.
    </ResponseField>

    <ResponseField name="platform_fee_amount" type="decimal">
      Add-on platform fee (default 0).
    </ResponseField>

    <ResponseField name="total_debit_amount" type="decimal">
      `amount + platform_fee_amount` — the total debited from the source virtual account.
    </ResponseField>

    <ResponseField name="receipt" type="object | null">
      Receipt breakdown.

      <Expandable title="child attributes">
        <ResponseField name="recipient_amount" type="decimal">
          Amount the beneficiary receives.
        </ResponseField>

        <ResponseField name="platform_fee" type="decimal">
          Platform fee charged on top of the recipient amount.
        </ResponseField>

        <ResponseField name="total_debit" type="decimal">
          Total debit from the source virtual account.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="enum">
      `PaymentStatus`: `pending_review`, `pending`, `processing`, `settled`, `failed`, `rejected`, `returned`.
    </ResponseField>

    <ResponseField name="submitted_at" type="datetime">
      When the payment order was created.
    </ResponseField>

    <ResponseField name="reviewed_at" type="datetime | null">
      When the payment was reviewed, if applicable.
    </ResponseField>

    <ResponseField name="settled_at" type="datetime | null">
      When the payment settled, if applicable.
    </ResponseField>

    <ResponseField name="failed_at" type="datetime | null">
      When the payment failed, if applicable.
    </ResponseField>

    <ResponseField name="transfer_at" type="datetime | null">
      Requested dispatch time, if scheduled.
    </ResponseField>

    <ResponseField name="scheduled_dispatched_at" type="datetime | null">
      When the scheduled payment was actually dispatched.
    </ResponseField>

    <ResponseField name="created" type="datetime">
      When the payment was created.
    </ResponseField>

    <ResponseField name="updated" type="datetime | null">
      When the payment was last updated.
    </ResponseField>

    <ResponseField name="created_by" type="string">
      Actor that created the payment.
    </ResponseField>

    <ResponseField name="updated_by" type="string | null">
      Actor that last updated the payment.
    </ResponseField>
  </Expandable>
</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",
        "id": "apo_5tg9m9p4q1w8e5r3t6y0u2i4",
        "type": "payment",
        "note": null,
        "reference": "Invoice 42",
        "payment_purpose": "supplier_or_vendor_payment",
        "beneficiary_id": "bene_2aq7c1e6a2b4f3c9b8d2e5a1",
        "beneficiary_name": "Globex Ltd",
        "source_account": "USD Ops ....7821",
        "destination_account": "USD ....7823",
        "currency": "USD",
        "amount": "1000.00",
        "platform_fee_amount": "25.00",
        "total_debit_amount": "1025.00",
        "receipt": {
          "recipient_amount": "1000.00",
          "platform_fee": "25.00",
          "total_debit": "1025.00"
        },
        "status": "pending_review",
        "submitted_at": "2026-05-30T09:00:00Z",
        "reviewed_at": null,
        "settled_at": null,
        "failed_at": null,
        "transfer_at": null,
        "scheduled_dispatched_at": null,
        "created": "2026-05-30T09:00:00Z",
        "updated": null,
        "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
        "updated_by": null
      }
    ],
    "page": 1,
    "size": 10,
    "total": 1,
    "pages": 1
  }
  ```
</ResponseExample>