Skip to main content
GET
/
transactions
/
{id}
Get a transaction by ID
curl --request GET \
  --url https://api.conduit.financial/v2/transactions/{id} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "customerId": "<string>",
  "source": {
    "type": "wallet",
    "walletId": "<string>",
    "address": "<string>",
    "assetAmount": {
      "code": "USDC",
      "chain": "ethereum",
      "amount": "100"
    }
  },
  "destination": {
    "type": "wallet",
    "walletId": "<string>",
    "address": "<string>",
    "assetAmount": {
      "code": "USDC",
      "chain": "ethereum",
      "amount": "100"
    }
  },
  "fees": [
    {
      "code": "FIXED_FEE",
      "type": "fixed",
      "assetAmount": {
        "code": "USDC",
        "chain": "ethereum",
        "amount": "100"
      }
    }
  ],
  "createdAt": "2026-01-15T09:30:00.000Z",
  "type": "deposit",
  "customerName": "<string>",
  "clientReferenceId": "<string>",
  "completedAt": "2026-01-15T09:30:00.000Z",
  "failureMessage": "<string>",
  "cancelledAt": "2026-01-15T09:30:00.000Z",
  "linkedOrderId": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Response

The requested transaction

Client-facing view of an inbound deposit (fiat or crypto credit into a customer VA/wallet).

​
id
string
required
Pattern: ^txn_[0-9A-Za-z]{22}$
​
customerId
string
required
Pattern: ^cus_[0-9A-Za-z]{22}$
​
status
enum<string>
required
Available options:
pending,
processing,
completed,
failed,
cancelled
​
source
object
required

One side (source or destination) of a transaction. Discriminated by type.

​
destination
object
required

One side (source or destination) of a transaction. Discriminated by type.

​
fees
object[]
required
​
createdAt
string<date-time>
required

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
type
enum<string>
required
Available options:
deposit
​
customerName
string

Display name of the customer that owns the transaction: business legal name or individual full name. Omitted when no name is available — either the create path didn't join the customer (e.g. the create-payout response) or the customer's identity record hasn't resolved a name yet. Per the public omit-don't-null convention, absence is never surfaced as null.

​
clientReferenceId
string
Pattern: ^[A-Za-z0-9_\-:.]{1,255}$
​
completedAt
string<date-time>

ISO 8601 timestamp

Example:

"2026-01-15T09:30:00.000Z"

​
failureCode
enum<string>
Available options:
USER_SIGNATURE_TIMEOUT,
USER_SIGNATURE_DECLINED,
USER_SIGNATURE_REJECTED_BY_PROVIDER,
CRYPTO_WALLET_MISCONFIGURED,
COMPLIANCE_HOLD,
AML_REJECTED,
COMPLIANCE_REJECTED,
RETURNED_BY_SENDER,
RAIL_POLICY_REJECTED,
INSUFFICIENT_FUNDS_AT_SETTLE,
RAIL_UNAVAILABLE,
SENDER_INFO_TIMEOUT,
TRAVEL_RULE_REJECTED,
PROVIDER_REJECTED,
CHAIN_BROADCAST_FAILED,
ROSTER_CHANGED
​
failureMessage
string

Human-readable description of failureCode. Defaults to the public error catalog text for the code; sandbox-driven failures may carry the operator-supplied reason instead.

​
cancelledAt
string<date-time>

ISO-8601 timestamp when the transaction was cancelled. Present only on status: cancelled.

Example:

"2026-01-15T09:30:00.000Z"

​
cancellationReason
enum<string>

Machine-readable cancellation reason. client_cancelled when the client called POST /v2/payouts/:id/cancel; expired is reserved. Omitted on non-cancelled rows. Mirrors orders.cancellationReason.

Available options:
expired,
client_cancelled
​
linkedOrderId
string
Pattern: ^ord_[0-9A-Za-z]{22}$
​
purpose
enum<string>

The business purpose declared at payout creation. Drives compliance gating: INTERCOMPANY requires a whitelisted recipient; other values require supporting documentation.

Available options:
INTERCOMPANY,
TREASURY_MANAGEMENT,
PAYMENT_FOR_GOODS_OR_SERVICES,
PAYROLL,
INVESTMENTS,
OTHER