---
title: "List x402 payments"
method: GET
path: "/x402/credit_account/payments"
tags: ["x402 Payment Transactions"]
---

# List x402 payments

`GET /x402/credit_account/payments`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/x402/credit_account/payments`
- Auth: HTTP bearer

Returns a paginated list of the authenticated user's x402 payment transactions, newest first. Organization sub-users must have read permission on transactions; without it the list is empty.

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

List of x402 payment transactions

- X402TransactionListResponse
  - `data` X402TransactionRecord[]
    - `id` string, uuid: Unique transaction identifier.
    - `record_type` 'x402_transaction'
    - `amount` string: The transaction amount in the specified currency.
    - `currency` string: The currency of the transaction amount (e.g. USD).
    - `status` 'settled': The settlement status of the transaction. x402 transactions are created after successful on-chain settlement, so the status is `settled`.
    - `quote_id` string: The original quote ID associated with this transaction.
    - `tx_hash` string, nullable: The on-chain transaction hash, if available.
    - `created_at` string, date-time: ISO 8601 timestamp when the transaction was created.
    - `updated_at` string, date-time: ISO 8601 timestamp when the transaction was last updated.
  - `meta` X402TransactionsPaginationMeta
    - `page_number` integer: The current page number.
    - `page_size` integer: The number of results per page.
    - `total_pages` integer: The total number of pages.
    - `total_results` integer: The total number of results.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — x402 payments not enabled or account tier ineligible

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/x402/credit_account/payments/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)