v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB

Account Connections

Get a single connection transaction by id

Fetches one persisted connection transaction by its transaction id (the transaction_id field returned by the list endpoints), scoped to the caller workspace.

get/v2/account-connections/transactions/{transactionId}

Path parameters

transactionIdstring required

Response

idstring required

Provider-native unique identifier for this event.

transaction_idstring

Persisted row id for this transaction. Present on reads from storage; absent on live adapter responses. Used to update category.

account_idstring required

Account (in this API) the event belongs to.

providerobject required

Connection provider that produced this event.

kind'TRANSFER' | 'TRADE' required

Discriminator: which event-specific payload is populated.

status'PENDING' | 'CONFIRMED' | 'FAILED' required

timestampstring nullable

Canonical event time (ISO 8601).

hashstring nullable

networkstring nullable

block_numberstring nullable

usd_amountstring nullable

Unsigned USD magnitude for this event (transfer notional or trade notional). Encrypted at rest with the financial payload; used by min_usd / max_usd filters.

categorystring nullable

User-assigned category label. Null when unset. Survives provider re-sync.

rawobject required

Provider-native fields that are not part of the canonical shape (escape hatch; never relied upon by consumers).

Example response

{
  "id": "0x9a3f...",
  "transaction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "account_id": "acc_abc123",
  "kind": "TRADE",
  "status": "CONFIRMED",
  "timestamp": "2026-01-15T10:00:00.000Z",
  "hash": "0xabc...",
  "network": "networks/ethereum-mainnet",
  "block_number": "21000000",
  "usd_amount": "250.50",
  "transfers": [
    {
      "direction": "IN",
      "asset": "USDC",
      "amount": "100.50",
      "usd_amount": "9.831",
      "source_address": "0xabc...",
      "destination_address": "0xdef..."
    }
  ],
  "trade": {
    "side": "BUY",
    "base_asset": "BTC",
    "base_amount": "0.01",
    "quote_asset": "USDC",
    "quote_amount": "500.0",
    "price": "50000.0",
    "fee": "0.45",
    "fee_asset": "USDC",
    "realized_pnl": "25.11"
  },
  "category": "Payroll",
  "raw": {}
}