List Transactions

Search and paginate through transactions using flexible filter parameters. Authorization is via API key.

Request

GET /api/v1/transactions?query_params
Headers: x-api-key: <your_api_key>

Filter Parameters

Param	Description	Example
unspecified_id	Match any known identifier (internal, external, provider)	10077001
started_to	Started before timestamp (ISO)	2025-09-01T10:45:14Z
started_from	Started after timestamp (ISO)	2025-09-01T10:45:14Z
updated_to	Updated before timestamp (ISO)	2025-09-01T11:45:14Z
updated_from	Updated after timestamp (ISO)	2025-09-01T11:45:14Z
type	payment or payout	payment
status	Transaction status	charged
env	Environment	prod
amount_to	Amount <= (minor units)	10000
amount_from	Amount >= (minor units)	10000
txid	Client external id	98817018
order_by	Sort by started or updated	started
limit	Page size (default 100)	50
page	Page number (1-based)	2

Example

curl --location 'https://app.heth.me/api/v1/transactions?started_from=2025-09-01T10:45:14Z&type=payment&status=charged&order_by=started&limit=30&page=2' \\
  --header 'x-api-key: YOUR_KEY'

Response Shape

[
  {
    "id": "c033ceaa-3726-4479-8be3-c9af8a0b2336",
    "txid": "10077001",
    "type": "payment",
    "status": "charged",
    "amount": 10000,
    "currency": "USDT",
    "env": "prod",
    "started": "2025-09-05T13:57:56Z",
    "finished": "2025-09-05T13:58:10Z",
    "route": null
  }
]

Notes

• Use unspecified_id for broad fuzzy identification across multiple identifier fields.
• Prefer narrowing with time windows for performance.
• Pagination defaults: limit=100, page=1.
• Combine order_by with pagination for consistent traversal.