List links

List your payment links, newest first, with each one's payment count and volume.

Returns links newest first.

Query

status string

active or archived.
q string

Searches the name, description, code and ID.
limit integer

Page size, from 1 to 100. Defaults to 25.
cursor string

The next_cursor from the previous page. See pagination.

Errors

400 invalid_request

A filter has a value it can't take, or the cursor belongs to another list.

Any request can also fail on its key or its body. See errors.

Request

curl "https://api.402pay.co/api/v1/links?status=active&limit=10" \
  -H "Authorization: Bearer $PAY402_SECRET_KEY"

const response = await fetch("https://api.402pay.co/api/v1/links?status=active&limit=10", {
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
  },
});
const { data } = await response.json();

import os

import requests

response = requests.get(
    "https://api.402pay.co/api/v1/links?status=active&limit=10",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
)
data = response.json()["data"]

Response200 OK

{
  "data": [
    {
      "id": "lnk_nt842tPNne3lf0ka",
      "kind": "link",
      "code": "v6e4mrczwg",
      "url": "https://checkout.402pay.co/checkout/v6e4mrczwg",
      "name": "Team plan, monthly",
      "description": "Everything in Pro for up to 10 people.",
      "amount": "199.00",
      "currency": "USD",
      "success_url": null,
      "status": "active",
      "disabled_at": null,
      "payments_count": 0,
      "volume": {
        "amount": "0.00",
        "currency": "USD"
      },
      "created_at": "2026-09-26T21:22:46.992Z",
      "updated_at": "2026-09-26T21:22:46.992Z"
    }
  ],
  "has_more": true,
  "next_cursor": "lnk_nt842tPNne3lf0ka"
}