Pay: invoices

List invoices

GET/v1/invoices

Authentication: API key (Authorization: Bearer)
Required scope: pay:read

Cursor-paginated list: see Pagination.

Query parameters#

statusstring
Values waiting confirming paid underpaid overpaid expired paid_late canceled held
chain_idinteger · int64
EVM chain id: 56 BNB Chain, 1 Ethereum, 8453 Base, 42161 Arbitrum One, 137 Polygon, 728126428 TRON.
external_refstring
created_afterstring
ISO 8601 date or date-time, inclusive.
created_beforestring
ISO 8601 date or date-time, exclusive.
limitinteger
Default 50
1 to 100
cursorstring
Opaque next_cursor of the previous page.

Responses#

200One page of invoices.

Object fields

dataarray of objectrequired
Fields of each item
- idstring · uuid
- objectstring
  Values invoice
- statusstring
  Values waiting confirming paid underpaid overpaid expired paid_late canceled held
- environmentstring
  Values test live
- external_refstringnullable
- variantstring
  Values A B
- chain_idintegernullable
  Chain of the payment (set at creation when one chain is offered).
- tokenstringnullable
- decimalsintegernullable
- amount_dueany
- amount_receivedany
- amount_pendingany
- differencestringnullable
  Signed difference to the amount due, native units.
- priceobjectnullable
  Object fields
  - currencystring
  - price_e6string
  - fx_rate_e6string
    Units of the currency for 1 USDT, in millionths, frozen at creation.
  - fx_sourcestring
  - fx_as_ofstring · date-time
- chainsarray of object
  Fields of each item
  - amountstring
    Native units, e.g. 12500000 for 12.5 USDT with 6 decimals.
  - amount_formattedstring
  - decimalsinteger
  - chain_idinteger
  - tokenstring
  - deposit_addressstring
    Base58 T… on TRON.
  - payment_uristringnullable
    EIP-681 URI for a QR code (EVM chains).
- expires_atstring · date-time
- paid_atstring · date-timenullable
- created_atstring · date-time
- metadataobject
has_morebooleanrequired
next_cursorstringrequirednullable

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl "https://aicscan.io/v1/invoices?chain_id=56&limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/invoices?chain_id=56&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/invoices?chain_id=56&limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Response 200

JSON

{
  "data": [
    {
      "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
      "object": "invoice",
      "status": "waiting",
      "environment": "test",
      "external_ref": "string",
      "variant": "A",
      "chain_id": 56,
      "token": "string",
      "decimals": 0,
      "amount_due": null,
      "amount_received": null,
      "amount_pending": null,
      "difference": "string",
      "price": {
        "currency": "string",
        "price_e6": "string",
        "fx_rate_e6": "string",
        "fx_source": "string",
        "fx_as_of": "2026-11-14T09:30:13Z"
      },
      "chains": [
        {
          "amount": "string",
          "amount_formatted": "string",
          "decimals": 0,
          "chain_id": 56,
          "token": "string",
          "deposit_address": "string",
          "payment_uri": "string"
        }
      ],
      "expires_at": "2026-11-14T09:30:13Z",
      "paid_at": "2026-11-14T09:30:13Z",
      "created_at": "2026-11-14T09:30:13Z",
      "metadata": {}
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}