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

# List Orders

> List your payment orders, with pagination and status/token filters.

Returns the authenticated sender's payment orders, most recent first.

### Header Parameters

<ParamField header="API-Key" type="string" required>
  Unique API key issued manually through Telegram.
</ParamField>

### Query Parameters

<ParamField query="status" type="string">
  Filter by lifecycle state: `initiated`, `pending`, `expired`, `settled`, `refunded`.
</ParamField>

<ParamField query="token" type="string">
  Filter by token symbol (e.g. `USDC`).
</ParamField>

<ParamField query="ordering" type="string">
  Sort direction by creation time: `asc` or `desc` (default `desc`).
</ParamField>

<ParamField query="page" type="integer">
  Page number (default `1`).
</ParamField>

<ParamField query="pageSize" type="integer">
  Records per page.
</ParamField>

### Response

<ResponseField name="status" type="string">Response state (`success`).</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="total" type="integer">Total matching records.</ResponseField>
  <ResponseField name="page" type="integer">Current page.</ResponseField>
  <ResponseField name="pageSize" type="integer">Records per page.</ResponseField>
  <ResponseField name="orders" type="array">The page of orders.</ResponseField>
</ResponseField>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Payment orders retrieved successfully",
    "data": {
      "total": 42,
      "page": 1,
      "pageSize": 20,
      "orders": [
        {
          "id": "c7326d65-dfff-44c2-8bcc-c0756dfb6c0a",
          "amount": "10",
          "token": "USDC",
          "network": "base",
          "rate": "1377.50",
          "status": "pending"
        }
      ]
    }
  }
  ```
</ResponseExample>