Agora Finance Public Documentation

{
  "id": "1f0a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "initiatedAt": "2026-06-21T14:02:00Z",
  "isInstantSettlement": false,
  "legCount": 2,
  "recipient": {
    "accountId": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
    "address": "0xF5e6D7c8B9A0F5e6D7c8B9A0F5e6D7c8B9A0F5e6",
    "amounts": [
      {
        "amount": "250000.000000",
        "currency": "ausd"
      }
    ],
    "chain": "ethereum",
    "kind": "wallet",
    "name": "ETH treasury"
  },
  "settledAt": "2026-06-21T14:46:00Z",
  "source": {
    "accountId": null,
    "accountNumber": "987654321234",
    "amounts": [
      {
        "amount": "250000.000000",
        "currency": "usd"
      }
    ],
    "bankName": "JPMorgan Chase",
    "kind": "bank",
    "name": "Acme Corp"
  },
  "status": "settled",
  "type": "mint",
  "legs": [
    {
      "id": "9c8b7a6e-5d4c-3b2a-1f0e-9d8c7b6a5e4d",
      "amount": "250000.000000",
      "currency": "usd",
      "detail": {
        "imad": "20260621MMQFMP6K000482",
        "type": "wire"
      },
      "direction": "TO_AGORA",
      "occurredAt": "2026-06-21T14:02:00Z",
      "recipient": {
        "accountId": null,
        "accountNumber": null,
        "bankName": null,
        "kind": "bank",
        "name": "Agora"
      },
      "source": {
        "accountId": null,
        "accountNumber": "987654321234",
        "bankName": "JPMorgan Chase",
        "kind": "bank",
        "name": "Acme Corp"
      }
    },
    {
      "id": "8b7a6e5d-4c3b-2a1f-0e9d-8c7b6a5e4d3c",
      "amount": "250000.000000",
      "currency": "ausd",
      "detail": {
        "transactionHash": "0x3ab1c9e7d5f2a8b4c6e0d1f3a5b7c9e1d3f5a7b9c1e3d5f7a9b1c3e5d7f9a1b3",
        "type": "token"
      },
      "direction": "FROM_AGORA",
      "occurredAt": "2026-06-21T14:46:00Z",
      "recipient": {
        "accountId": "7f3a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
        "address": "0xF5e6D7c8B9A0F5e6D7c8B9A0F5e6D7c8B9A0F5e6",
        "chain": "ethereum",
        "kind": "wallet",
        "name": "ETH treasury"
      },
      "source": {
        "accountId": null,
        "address": null,
        "chain": "ethereum",
        "kind": "wallet",
        "name": "Agora"
      }
    }
  ]
}

Retrieve one settled transaction by id, with its per-leg breakdown. Each leg carries a direction (FROM_AGORA or TO_AGORA) and a rail-specific detail keyed by type: token (transactionHash), wire (Fedwire imad), bookTransfer, or instantPayment (confirmationNumber). A fee leg is a manual accounting entry and carries no rail reference. A 404 means no such transaction exists for your organization.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Path parameters

txnIdstringRequiredformat: "uuid"

Response

idstringformat: "uuid"

Stable UUID identifying this transaction; pass to the detail endpoint to fetch legs.

initiatedAtdatetime

ISO-8601 timestamp of the first leg.

isInstantSettlementboolean

True if this transaction used Agora's instant-settlement path rather than standard settlement.

legCountinteger

Number of customer-facing legs in this transaction.

recipientobject

The counterparty receiving value, with the totals it received.

settledAtdatetime or null

ISO-8601 timestamp when the transaction settled. Null until settled.

sourceobject

The counterparty sending value, with the totals it sent.

statusstring

Lifecycle status. v1 emits only "settled". This is an open, extensible enum; future values (e.g. pending) may appear, so clients must tolerate unknown values.

typestring

Customer-facing transaction type: mint, redeem, bridge, reward, or return. Treated as an open enum; tolerate unknown values.

legslist of objects

The customer-facing legs that make up this transaction.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error