> For the complete documentation index, see [llms.txt](https://k4k3ru.gitbook.io/k4k3ru-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://k4k3ru.gitbook.io/k4k3ru-docs/api/payment/list-onchain-intents.md).

# List Onchain Payment Intents

`POST https://api.k4k3ru.com/` using signed JSON-RPC method `PaymentOnchain.ListIntents`. Use the common [request authentication](/k4k3ru-docs/api/authentication.md) envelope.

## Parameters

| Field  | Type   | Required | Description                                  |
| ------ | ------ | -------- | -------------------------------------------- |
| `page` | number | Yes      | One-based integer, at most 9007199254740991. |

The account is derived from the authenticated API credential. An account override is not supported. Results contain only that account's intents, across statuses, ordered by `created_at DESC, id DESC`. Each page contains at most 20 intents. Count and page are read in one database snapshot; changes between separate page requests can still shift offset pagination.

## Result

| Field        | Type   | Description                                                  |
| ------------ | ------ | ------------------------------------------------------------ |
| `intents`    | array  | Intent objects; empty when no rows match the requested page. |
| `page`       | number | Requested page.                                              |
| `limit`      | number | Always 20.                                                   |
| `total`      | number | Number of this account's intents.                            |
| `totalPages` | number | Ceiling of total / 20; zero for an empty account.            |

Each intent contains `intentId`, `accountId` (decimal strings), `status`, `chain`, `network`, `symbol`, `recipientAddress`, `amount`, `expiresAt`, `createdAt`, and optional `metadata`. Times use RFC 3339. `amount` is a decimal string containing integer token **base units**, matching `GetIntent`; convert using the token's decimals for display.

Missing/invalid pages return `invalid_parameter`. Signature authentication is required. Use [GetIntent](/k4k3ru-docs/api/payment/get-onchain-intent.md) to refresh a selected intent's current payment details.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://k4k3ru.gitbook.io/k4k3ru-docs/api/payment/list-onchain-intents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.