API Reference

Transactions

Read settlement transactions with their lifecycle, on-ledger proof, and counterparty references. Cursor-paginated; idempotent reads.

Live testnet

Run a real settlement

One click submits a 0.001 XRP Payment to the public XRPL testnet from a Hundi-funded source wallet to a freshly-generated destination. Returns the validated on-ledger anchor.

List

GET /v1/transactions?status=settled&limit=50&cursor=<opaque>
Authorization: Bearer <jwt>

Read one

GET /v1/transactions/tx_01HVKZ7AY3P0...
Authorization: Bearer <jwt>

Response

{
  "transaction_id":   "tx_01HVKZ7AY3P0...",
  "quote_id":         "qte_01HVKZ5T9X2Q...",
  "status":           "settled",
  "send":             { "currency": "USD", "amount": "2000000.00" },
  "receive":          { "currency": "INR", "amount": "166240000.00" },
  "originator_did":   "did:hundi:0xa12c...",
  "beneficiary_did":  "did:hundi:0x91b7...",
  "ledger_anchor": {
    "ledger":         "xrpl-mainnet",
    "ledger_index":   84219007,
    "tx_hash":        "0x4e9a...",
    "settled_at":     "2026-05-06T12:00:05.247Z"
  },
  "audit_proof_url": "https://api.hundi.network/v1/transactions/tx_01HVKZ7AY3P0.../proof"
}