Lister les transactions

Recherche et pagination sur les transactions avec filtres. Authentification API key.

Requête

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

Filtres

Param	Description	Exemple
unspecified_id	Correspond à tout identifiant connu	10077001
started_to	Début avant (ISO)	2025-09-01T10:45:14Z
started_from	Début après (ISO)	2025-09-01T10:45:14Z
updated_to	MAJ avant	2025-09-01T11:45:14Z
updated_from	MAJ après	2025-09-01T11:45:14Z
type	payment ou payout	payment
status	Statut	charged
env	Environnement	prod
amount_to	Montant <=	10000
amount_from	Montant >=	10000
txid	ID externe (UUID)	f47ac10b-58cc-4372-a567-0e02b2c3d479
order_by	Tri (started/updated)	started
limit	Taille de page (défaut 100)	50
cursor	Curseur d'une réponse précédente pour la page suivante	(voir Format de réponse)

Exemple

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

Format de réponse

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

• Les résultats sont encapsulés dans data ; cursor contient la position de la page suivante.
• unspecified_id couvre plusieurs types d'identifiants.
• Réduire la fenêtre temporelle pour de meilleures performances.
• La pagination est basée sur un curseur (défaut limit 100) ; passez cursor de la réponse précédente pour la page suivante.