---
title: "Retrieve one transaction"
method: GET
path: "/transactions/{transactionId}"
tags: ["transactions"]
---

# Retrieve one transaction

`GET /transactions/{transactionId}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

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

## Path parameters

- `transactionId` string, required: Prefixed transaction id

## Headers

- `X-Hevn-Account` string, nullable: The client account to act for, as a `cl_…` id. Omit it to act as yourself.

## Response `200`

Successful Response

- TransactionDetailView
  - `id` string, nullable: Stable public identifier for this transaction.
  - `type` string, required: Public transaction type.
  - `status` 'pending' | 'rfi' | 'success' | 'failed' | 'refunded', required
  - `isIncome` boolean, required: Whether this transaction increases the selected account's balance.
  - `from` TransactionSideView
    - `amount` string, required: Amount on this side of the transaction.
    - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
    - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
  - `to` TransactionSideView
    - `amount` string, required: Amount on this side of the transaction.
    - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
    - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
  - `fee` TransactionSideView
    - `amount` string, required: Amount on this side of the transaction.
    - `currency` string, required: ISO 4217 fiat code or supported digital-asset symbol.
    - `usdRate` string, nullable: Indicative conversion rate from this asset into USD.
  - `account` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS'
  - `counterparty` string, nullable: Human-readable counterparty name.
  - `paymentReference` string, nullable: Reference or memo associated with the transfer.
  - `remitter` string, nullable: Originator information reported by the payment network.
  - `txHash` string, nullable: On-chain transaction hash associated with this ledger entry.
  - `tag` string, nullable: Public transaction classification tag.
  - `hasAttachments` boolean: Whether supporting documents are attached.
  - `createdAt` string, date-time, required: UTC timestamp when the transaction was created.
  - `description` string, nullable: Human-readable description supplied for this transaction.
  - `explorerUrl` string, nullable: Public blockchain-explorer URL for the transaction.
  - `traceNumber` string, nullable: Account-transfer or payment-network trace identifier.
  - `attachmentIds` string[]: Supporting document identifiers.

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 2 warning, 2 info
  - added the new `FDIC_EUR` enum value to the `account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - removed the `phone_required` enum value from the `error/code` response property for the response status `422`
  - removed the `rail_requirements_unmet` enum value from the `error/code` response property for the response status `422`
- **2026-10-23** `a02795de2d2b`: 9 warning, 6 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `client_already_linked` enum value to the `error/code` response property for the response status `422`
  - added the new `kyb_documents_processing` enum value to the `error/code` response property for the response status `422`
  - added the new `link_code_expired` enum value to the `error/code` response property for the response status `422`
  - …11 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/transactions/:transactionId/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)