Pay: invoices

List received payments

GET/v1/payments

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

Cursor-paginated list: see Pagination.

Query parameters#

chain_idinteger · int64
EVM chain id: 56 BNB Chain, 1 Ethereum, 8453 Base, 42161 Arbitrum One, 137 Polygon, 728126428 TRON.
invoice_idstring · uuid
statusstring
Values pending confirmed orphaned
unattributedboolean
true: only payments matching no open invoice (variant B).
limitinteger
Default 50
1 to 100
cursorstring
Opaque next_cursor of the previous page.

Responses#

200One page of payments.

Object fields

dataarray of objectrequired
Fields of each item
- amountstring
  Native units, e.g. 12500000 for 12.5 USDT with 6 decimals.
- amount_formattedstring
- decimalsinteger
- idstring · uuid
- objectstring
  Values payment
- invoice_idstring · uuidnullable
  null: unattributed payment.
- environmentstring
  Values test live
- chain_idinteger
- tx_hashstring
- log_indexinteger
- block_numberinteger
- block_timestring · date-time
- fromstring
- tokenstringnullable
- statusstring
  Values pending confirmed orphaned
- ignored_reasonstringnullable
  Values dust unattributed other_chain other_token null
- sanction_hitboolean
- created_atstring · date-time
has_morebooleanrequired
next_cursorstringrequirednullable

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

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

JavaScript

const res = await fetch('https://aicscan.io/v1/payments?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/payments?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": [
    {
      "amount": "string",
      "amount_formatted": "string",
      "decimals": 0,
      "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
      "object": "payment",
      "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
      "environment": "test",
      "chain_id": 56,
      "tx_hash": "string",
      "log_index": 0,
      "block_number": 0,
      "block_time": "2026-11-14T09:30:13Z",
      "from": "string",
      "token": "string",
      "status": "pending",
      "ignored_reason": "dust",
      "sanction_hit": false,
      "created_at": "2026-11-14T09:30:13Z"
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}