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	98817018
order_by	Tri (started/updated)	started
limit	Taille de page (défaut 100)	50
page	Numéro de page (1+)	2

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&page=2' \
  --header 'x-api-key: VOTRE_CLE'

Format de réponse

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

• unspecified_id couvre plusieurs types d'identifiants.
• Réduire la fenêtre temporelle pour de meilleures performances.
• Valeurs par défaut: limit=100, page=1.
• Utiliser order_by avec pagination pour un parcours stable.