List links | Mitu API Documentation

{
  "message": "Payment links retrieved successfully",
  "data": [
    {
      "id": "pay_n8d7piu1yc6h",
      "type": "charge",
      "status": "pending",
      "amount": "25.00",
      "amount_paid": "0.00",
      "currency": "USD",
      "description": "Two large pizzas",
      "reference": "ORDER-8841",
      "url": {
        "checkout": "https://mitu.ai/pay/pay_n8d7piu1yc6h",
        "agent": "https://api.mitu.ai/pay/pay_n8d7piu1yc6h"
      },
      "payment_methods": [
        "x402"
      ],
      "viewed_at": "2026-09-11T15:02:11.004Z",
      "expires_at": "2026-09-30T23:59:59.000Z",
      "paid_at": "2026-09-11T15:00:34.915Z",
      "created_at": "2026-09-11T15:00:34.915Z"
    }
  ],
  "meta": {
    "total": 84,
    "limit": 20,
    "has_more": true,
    "next_cursor": "cur_01HXYZ9999XXXXXX"
  }
}

List your payment links.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Query parameters

typeenumOptional

Filter by payment link type.

Allowed values:

statusenumOptional

Filter by payment link status.

referencestringOptional

Filter by your payment reference.

sourceenumOptional

Filter by the source that created the payment link.

Allowed values:

limitintegerOptional1-100Defaults to 20

Maximum number of records to return.

cursorstringOptional

Cursor returned as next_cursor from the previous response. Omit for the first request.

Response

Payment links retrieved successfully.

messagestring

datalist of objects

metaobject

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error