Skip to main content
GET
Get Transaction by ID

Authorizations

Authorization
string
header
required

Bearer token authentication, for client-server calls.

Send the access token issued by POST /v1/auth/token as Authorization: Bearer {token}. The token carries its own program and user context, so the X-Meridian-* headers are not required. See Authentication.

Headers

X-Meridian-Api-Key
string

Server-to-server (HMAC) requests only. Partner API key issued by Meridian during provisioning.

X-Meridian-Timestamp
string

Server-to-server (HMAC) requests only. Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request.

X-Meridian-Program-Id
string

Server-to-server (HMAC) requests only. Identifies the program context for the request.

X-Meridian-User-Id
string

Server-to-server (HMAC) requests only. Identifies the Meridian user targeted by the request. Required for MULTI_USER integrations; omit for SINGLE_USER.

Path Parameters

transactionId
string
required

ID of the transaction to fetch — the id returned by GET /v1/transactions.

Response

The transaction details for the authenticated account

A Meridian transaction

id
string
required

Unique identifier of the transaction

Example:

"txn_01JMERCRYPTOACH01"

type
enum<string>
required

Type of transaction

Available options:
TRANSFER,
DEPOSIT,
WITHDRAWAL,
REFUND,
PARTIAL_REFUND
Example:

"DEPOSIT"

status
string
required

Current status of the transaction

Example:

"COMPLETED"

referenceNumber
string
required

Reference number of the transaction

Example:

"dep-20260430-1001"

debitAmount
string
required

Amount debited as a decimal string

Example:

"7250.00"

debitCurrency
string
required

ISO 4217 currency code on the debit side

Example:

"USD"

creditAmount
string
required

Amount credited as a decimal string

Example:

"7250.00"

creditCurrency
string
required

ISO 4217 currency code on the credit side

Example:

"USD"

fees
Transaction Fee · object[]
required

Fees applied to the transaction

exchangeRate
string
required

Exchange rate applied

Example:

"1"

tags
string[]
required

Tags associated with the transaction

subtype
enum<string> | null

Finer-grained classification of the transaction. INTERNAL_SWEEP marks the internal movement from a sub-balance to its parent account rather than a transfer the user made

Available options:
AUTOSWEEP,
CASH_IN,
P2P,
MERCHANT,
MANUAL,
AUTOPAY,
DIRECT_DEBIT,
INTERNAL_SWEEP,
REWARD,
YIELD_FUNDING,
YIELD_PAYOUT,
null
Example:

"INTERNAL_SWEEP"

createdAt
string<date-time> | null

Timestamp when the transaction was created

Example:

"2026-04-30T15:00:00Z"

updatedAt
string<date-time> | null

Timestamp when the transaction was last updated

Example:

"2026-04-30T15:02:00Z"

completedAt
string<date-time> | null

Timestamp when the transaction reached a settled state; absent while it is still in flight

Example:

"2026-04-30T15:05:00Z"

statusReason
string | null

Reason for the current status

reason
string | null

Machine-readable code for the current status, suitable for branching on. Prefer this over statusReason, which is free text. See Transaction reason codes for what each code means and what to do

Example:

"INSUFFICIENT_FUNDS"

externalId
string | null

External identifier of the transaction

depositReconciliationId
string | null

Deposit reconciliation identifier copied from the destination account for deposit transactions

ID of a related transaction

netDebitAmount
string | null

Amount debited net of fees, as a decimal string. Absent when the transaction carries no stored net figure, which is not the same as a net of zero

Example:

"7249.00"

debitParty
Transaction Party · object | null

External party on the credit side, present on a payout to a beneficiary and absent on a deposit. The authenticated user's own side of the transaction is always in debitInstrument or creditInstrument rather than here

debitRail
string | null

Payment rail used on the debit side

Example:

"US.USD.ACH"

debitMemo
string | null

Remittance information the sender attached to the payment. Wire and SWIFT carry it; ACH has no such field, so this is absent on ACH deposits. A sandbox simulated deposit may report its reference here, depending on the backing provider. For the payer's own reference, see debitReference

Example:

"INV-23014"

debitReference
string | null

Reference supplied by the payer on the debit leg, as opposed to referenceNumber, which Meridian generates. For an on-chain debit this is the settling blockchain transaction hash; for a fiat rail it is that rail's own reference. Read debitRail to tell the two apart. A sandbox simulated deposit reports its reference here

Example:

"0xabcdef"

debitEntryDescriptor
string | null

Descriptor Meridian presents to the paying bank for the debit leg, which the payer may see on their own statement. Absent when the transaction carries none

Example:

"PAYROLL"

debitInstrument
Account Instrument · object

Meridian (balance) account instrument

creditParty
Transaction Party · object | null

External party on the credit side, present on a payout to a beneficiary and absent on a deposit. The authenticated user's own side of the transaction is always in debitInstrument or creditInstrument rather than here

creditRail
string | null

Payment rail used on the credit side

creditInstrument
Account Instrument · object

Meridian (balance) account instrument

meridianRate
string | null

Meridian's own rate for the currency pair, before any spread, at full stored precision so that creditAmount can be reconciled against debitAmount and this rate

Example:

"56.50"

fxSpread
string | null

FX spread applied, as a decimal string. Reported separately from fees so that summing fees keeps its existing meaning

Example:

"0.02"

purpose
enum<string> | null

Payment purpose

Available options:
PAYMENT_FOR_SERVICES,
PAYMENT_FOR_SOFTWARE,
PAYMENT_FOR_IMPORTED_GOODS,
TRAVEL_SERVICES,
VENDOR_CONTRACTOR_PAYOUTS,
TRANSFER_TO_OWN_ACCOUNT,
INVESTMENT_IN_SHARES,
PURCHASE_OF_PROPERTY,
REPAYMENT_OF_LOANS,
SALARY,
PAYMENT_OF_PROPERTY_RENTAL,
INFORMATION_SERVICE_CHARGES,
ADVERTISING_AND_PUBLIC_RELATIONS_EXPENSES,
ROYALTY_TRADEMARK_PATENT_AND_COPYRIGHT_FEES,
BROKER_FRONTEND_GUARANTEE_AND_CUSTODIAN_FEES,
ADVISOR_TECHNICAL_AND_ACADEMIC_FEES,
REPRESENTATIVE_OFFICE_EXPENSES,
TAX_PAYMENT,
TRANSPORTATION_FEES_FOR_GOODS,
CONSTRUCTION_COSTS,
INSURANCE_PREMIUM,
GENERAL_GOODS_TRADES_OFFLINE,
INSURANCE_CLAIMS_PAYMENT,
FAMILY_MAINTENANCE,
EDUCATION_RELATED_EXPENSES,
MEDICAL_TREATMENT,
DONATIONS,
MUTUAL_FUND_INVESTMENT,
CURRENCY_EXCHANGE,
USER_WITHDRAWAL,
ADVANCE_PAYMENTS_FOR_GOODS,
VENDOR_CONTRACTOR_PAYOUTS_SOFTWARE_DEVELOPMENT,
MERCHANT_SETTLEMENT,
REPATRIATION_FUND_SETTLEMENT,
PERSONAL_REMITTANCE,
RETURN_OF_FUNDS,
null