List Transactions

List merchant invoices created via API

Endpoint

GET {BASE_URL}/crypto/v1/list-txs

List merchant invoice transactions

get

Query parameters

FromDatestringOptional

Date parseable by JavaScript new Date(...).

ToDatestringOptional

Date parseable by JavaScript new Date(...).

HideUnpaidstring · enumOptional

Only literal string true applies paidAmount filter.

Possible values:

Header parameters

apikeystringRequired

Merchant API key.

merchantidstringRequired

Merchant identifier bound to the API key.

Responses

200

List result

application/json

successconst: Required

countintegerRequired

totalPaidnumberRequired

400

Invalid FromDate or ToDate

application/json

403

Missing API key or merchant ID header

application/json

404

No transactions found

application/json

405

Invalid merchant ID or API key

application/json

408

Non-matching merchantid/API key

application/json

412

Merchant not enrolled

application/json

501

Credential validation server error

application/json

505

Reporting pipeline server error

application/json

get

/crypto/v1/list-txs

HTTPcURLJavaScriptPython

GET /crypto/v1/list-txs HTTP/1.1
Host: api.example.com
apikey: text
merchantid: text
Accept: */*

{
  "success": true,
  "count": 1,
  "totalPaid": 1,
  "details": [
    {
      "id": "text",
      "client": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "paidAmount": 1,
      "subTotal": 1,
      "total": 1,
      "partialPaymentsEnabled": true,
      "tippingEnabled": true,
      "currency": "text",
      "completed": true,
      "description": "text",
      "transactions": [
        {
          "tx": "text",
          "sender": "text",
          "amount": 1,
          "cryptoAmount": 1,
          "timestamp": "2026-03-21T19:03:34.546Z",
          "network": "text"
        }
      ],
      "createdAt": "2026-03-21T19:03:34.546Z",
      "merchant": {
        "name": "text",
        "initiator": "text"
      }
    }
  ]
}

Required Headers

Header	Required	Type
apikey	Yes	String
merchantid	Yes	String

Query Parameters

Parameter names are case-sensitive in current runtime behavior.

Parameter	Required	Type	Notes
FromDate	No	String	Date parseable by new Date(...)
ToDate	No	String	Date parseable by new Date(...)
HideUnpaid	No	String	Only string value true filters unpaid invoices

Request Example

GET {BASE_URL}/crypto/v1/list-txs?FromDate=2026-02-01&ToDate=2026-02-19&HideUnpaid=true

Success Response (200)

{
  "success": true,
  "count": 2,
  "totalPaid": 8.4,
  "details": [
    {
      "client": {
        "name": "First Name",
        "email": "[email protected]",
        "phone": "[phone]"
      },
      "paidAmount": 4.2,
      "subTotal": 4.2,
      "total": 4.2,
      "partialPaymentsEnabled": false,
      "currency": "USDC",
      "completed": true,
      "description": "Payment Description",
      "transactions": [
        {
          "tx": "0xe45f9b59fffd9c2b3d945acf4a076804dfc625e5890de0a0e9fb2a0e42a983a4",
          "sender": "0xD15aE11e29b002d41ae5dbcb2eDF4ED0b91cC4e5",
          "amount": 4.2,
          "cryptoAmount": 4200000,
          "timestamp": "2024-06-24T05:49:35.000Z",
          "network": "ETH"
        }
      ],
      "createdAt": "2024-06-24T05:19:56.854Z",
      "merchant": {
        "name": "Business Name",
        "initiator": "POS API Key Name"
      },
      "id": "667901fcb753825891f6337e"
    }
  ]
}

Not Found Example (404)

{
  "success": false,
  "error": "Transactions not found."
}

Invalid Date Example (400)

{
  "error": "Invalid FromDate"
}

Error Statuses

Status	Meaning
200	Success
400	Invalid FromDate or ToDate
403	Missing apikey or merchantid
404	No transactions found for filters
405	Invalid API key or merchant ID
408	API key and merchant mismatch
412	Merchant not enrolled in cryptoPOS-V1
501	Credential validation server error
505	Reporting pipeline server error