Pay: refunds

Get a refund

GET/v1/refunds/{id}

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

Path parameters#

idstring · uuidrequired

Responses#

200Refund.

Object fields

amountstring
Native units, e.g. 12500000 for 12.5 USDT with 6 decimals.
amount_formattedstring
decimalsinteger
idstring · uuid
objectstring
Values refund
environmentstring
Values test live
invoice_idstring · uuidnullable
chain_idinteger
tokenstringnullable
to_addressstring
statusstring
Values prepared pending succeeded failed canceled
tx_hashstringnullable
warningsarray of string
Values origin_address exchange_address
created_atstring · date-time
updated_atstring · date-time

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl "https://aicscan.io/v1/refunds/0193a1d4-2b3c-7d4e-9f5a-6b7c8d9e0f1a" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/refunds/0193a1d4-2b3c-7d4e-9f5a-6b7c8d9e0f1a', {
  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/refunds/0193a1d4-2b3c-7d4e-9f5a-6b7c8d9e0f1a",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Response 200

JSON

{
  "amount": "string",
  "amount_formatted": "string",
  "decimals": 0,
  "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "object": "refund",
  "environment": "test",
  "invoice_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
  "chain_id": 56,
  "token": "string",
  "to_address": "string",
  "status": "prepared",
  "tx_hash": "string",
  "warnings": [
    "origin_address"
  ],
  "created_at": "2026-11-14T09:30:13Z",
  "updated_at": "2026-11-14T09:30:13Z"
}