Transaktionsliste

Suchen und paginieren Sie durch Transaktionen mit flexiblen Filtern. Autorisierung via API-Key.

Anfrage

GET /api/v1/transactions?query_params
Header: x-api-key: <api_key>

Filterparameter

Param	Beschreibung	Beispiel
unspecified_id	Beliebiger Identifier (intern/extern/provider)	10077001
started_to	Start vor Zeit (ISO)	2025-09-01T10:45:14Z
started_from	Start nach Zeit (ISO)	2025-09-01T10:45:14Z
updated_to	Update vor Zeit	2025-09-01T11:45:14Z
updated_from	Update nach Zeit	2025-09-01T11:45:14Z
type	payment oder payout	payment
status	Status	charged
env	Umgebung	prod
amount_to	Betrag <=	10000
amount_from	Betrag >=	10000
txid	Externe ID (UUID)	f47ac10b-58cc-4372-a567-0e02b2c3d479
order_by	Sortierfeld (started/updated)	started
limit	Seitengröße (Default 100)	50
cursor	Cursor aus vorheriger Antwort für die nächste Seite	(siehe Antwortformat)

Beispiel

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: IHR_KEY'

Antwortformat

{
  "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"
  }
}

Hinweise

• Ergebnisse sind in data verpackt; cursor enthält die Position für die nächste Seite.
• unspecified_id für breite Identifier-Suche.
• Zeitfenster einschränken für Performance.
• Pagination ist cursor-basiert (Default limit 100); cursor aus der vorherigen Antwort für die nächste Seite übergeben.