Skip to main content
GET
/
x402
/
payment_instructions
List Payment Instructions
curl --request GET \
  --url https://api.pinata.cloud/v3/x402/payment_instructions \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "payment_instructions": [
      {
        "id": "<string>",
        "version": 123,
        "payment_requirements": [
          {
            "asset": "<string>",
            "pay_to": "<string>",
            "network": "base",
            "description": "<string>",
            "max_amount_required": "<string>"
          }
        ],
        "name": "<string>",
        "description": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "next_page_token": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Pinata API JWT token

Query Parameters

limit
integer
default:10

Number of items to return

Required range: 1 <= x <= 1000
pageToken
string

Token for pagination

cid
string

Filter by CID mapped (returns max 1 payment instruction)

name
string

Filter by name

id
string

Filter by ID

Response

Successful operation

data
object