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 (UUID)	f47ac10b-58cc-4372-a567-0e02b2c3d479
order_by	Sort by started or updated	started
limit	Page size (default 100)	50
cursor	Cursor from a previous response to fetch the next page	(see Response)

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' \
  --header 'x-api-key: YOUR_KEY'

Response Shape

{
  "data": [
    {
      "id": "c033ceaa-3726-4479-8be3-c9af8a0b2336",
      "txid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "payment",
      "status": "charged",
      "amount": "10000",
      "currency": "USDT",
      "env": "prod",
      "started": "2025-09-05T13:57:56Z",
      "finished": "2025-09-05T13:58:10Z",
      "route": null
    }
  ],
  "cursor": {
    "cursor_field": "started",
    "cursor_value": "2025-09-05T13:58:10Z"
  }
}

Notes

• Results are wrapped in data; cursor carries the position for the next page.
• Use unspecified_id for broad fuzzy identification across multiple identifier fields.
• Prefer narrowing with time windows for performance.
• Pagination is cursor-based (default limit 100); pass cursor from the previous response to fetch the next page.