Retrieve one transaction

Retrieve one ledger transaction with detailed counterparties, payment references and attachments visible to the selected account.

GET /transactions/{transactionId}

Retrieve one transaction

cURL

curl --request GET \
  --url https://api.hevn.finance/dapi/v1/transactions/{transactionId} \
  --header 'Authorization: Bearer <token>'

200

{
  "type": "<string>",
  "status": "pending",
  "isIncome": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "txn_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41",
  "from": {
    "amount": "500.00",
    "currency": "<string>",
    "usdRate": "500.00"
  },
  "to": {
    "amount": "500.00",
    "currency": "<string>",
    "usdRate": "500.00"
  },
  "fee": {
    "amount": "500.00",
    "currency": "<string>",
    "usdRate": "500.00"
  },
  "counterparty": "<string>",
  "paymentReference": "<string>",
  "remitter": "<string>",
  "txHash": "<string>",
  "tag": "<string>",
  "hasAttachments": false,
  "description": "<string>",
  "explorerUrl": "<string>",
  "traceNumber": "<string>",
  "attachmentIds": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

Platform access token from POST /auth/token, carrying the platform audience and the developer_key_id of the registration that minted it. It acts as your own account; name a client you created with X-Hevn-Account: cl_…. Every request re-checks that the registration is still active and that the caller's source IP is inside its allowlist. A token is valid only against the server that issued it, so sandbox tokens are refused in production and production tokens in the sandbox.

Headers

X-Hevn-Account · string | null

The client account to act for, as a cl_… id. Omit it to act as yourself.

Example:

"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

x-api-key · string | null

Path Parameters

transactionId · string · required

Prefixed transaction id

Response

200

application/json

Successful Response

type · string · required

Public transaction type.

status · enum<string> · required

Current transaction lifecycle status.

Available options: pending, rfi, success, failed, refunded

isIncome · boolean · required

Whether this transaction increases the selected account's balance.

createdAt · string<date-time> · required

UTC timestamp when the transaction was created.

id · string | null

Stable public identifier for this transaction.

Pattern: ^(?:txn_)?[A-Za-z0-9._:\-]{1,216}$

Example:

"txn_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

from · TransactionSideView · object | null

Source side of the transaction.

Show child attributes

to · TransactionSideView · object | null

Destination side of the transaction.

Show child attributes

fee · TransactionSideView · object | null

Fee side of the transaction, when charged.

Show child attributes

counterparty · string | null

Human-readable counterparty name.

paymentReference · string | null

Reference or memo associated with the transfer.

remitter · string | null

Originator information reported by the payment network.

txHash · string | null

On-chain transaction hash associated with this ledger entry.

tag · string | null

Public transaction classification tag.

hasAttachments · boolean · default: false

Whether supporting documents are attached.

description · string | null

Human-readable description supplied for this transaction.

explorerUrl · string | null

Public blockchain-explorer URL for the transaction.

traceNumber · string | null

Account-transfer or payment-network trace identifier.

attachmentIds · string[]

Supporting document identifiers.