---
title: "List Payment Instructions"
method: GET
path: "/x402/payment_instructions"
---

# List Payment Instructions

`GET /x402/payment_instructions`

Returns a paginated list of payment instructions

## Query parameters

- `limit` integer
- `pageToken` string
- `cid` string
- `name` string
- `id` string

## Response `200`

Successful operation

- object
  - `data` object
    - `payment_instructions` PaymentInstruction[]
      - `id` string — Unique identifier
      - `version` integer — Version number
      - `payment_requirements` PaymentRequirement[]
        - `asset` string, required — Token contract address (must start with 0x)
        - `pay_to` string, required — Ethereum address to receive payment (must start with 0x)
        - `network` 'base' | 'base-sepolia' | 'eip155:8453' | 'eip155:84532', required — Network for payment (accepts friendly names or EIP-155 chain IDs)
        - `description` string — Optional description
        - `amount` string, required — Amount required for payment in smallest token unit
      - `name` string — Name of the payment instruction
      - `description` string — Description of the payment instruction
      - `created_at` string, date-time — Creation timestamp
    - `next_page_token` string — Token for next page (omitted on last page)

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/pinata/apis/pinata-v3-api.md) · [All operations](https://skmtc.net/pinata/apis/pinata-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinata/pinata-v3-api/versions/734684efd9c4/schema)