> ## Documentation Index > Fetch the complete documentation index at: https://docs.range.org/llms.txt > Use this file to discover all available pages before exploring further. # Get a single account transfer by id > Fetches one persisted account transfer by its transfer id (the `transaction_id` field returned by the list endpoints), scoped to the caller workspace. ## OpenAPI ````yaml /api-reference/platform-api.json get /v2/accounts/transfers/{transferId} openapi: 3.0.0 info: title: Range Platform API description: >- The Range Platform API for workspace management, counterparties, and operational tooling. version: 1.7.31 contact: {} servers: - url: https://api.range.org description: Range API Server security: - Authorization: [] - Authorization: [] tags: - name: Address Information description: Get information about a crypto address. - name: Transfer Enrichments description: Attach workspace-scoped notes and categories to transfers. - name: Counterparties description: Manage external entities, their addresses, bank accounts, and documents. - name: Parties description: >- The workspace entity register: the firm itself, its clients, and its counterparties. paths: /v2/accounts/transfers/{transferId}: get: tags: - Accounts summary: Get a single account transfer by id description: >- Fetches one persisted account transfer by its transfer id (the `transaction_id` field returned by the list endpoints), scoped to the caller workspace. operationId: getAccountTransactionById parameters: - name: transferId required: true in: path schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/CanonicalConnectionTransactionDto' components: schemas: CanonicalConnectionTransactionDto: type: object properties: id: type: string example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 description: >- Unique identifier for this event. On persisted reads this is the DB row id (stable across accounts that share a provider-native event). On live adapter responses it is the provider-native id used as the upsert key. transaction_id: type: string example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 description: >- Persisted row id for this transaction. Present on reads from storage; absent on live adapter responses. Used to update category. On persisted reads this matches `id`. provider_transaction_id: type: string example: 0x9a3f... description: >- Provider-native event id used as the upsert key. Present on persisted reads; on live adapter responses the same value lives in `id`. account_id: type: string example: acc_abc123 description: Account (in this API) the event belongs to. account: description: >- Workspace Account this event belongs to. Present on persisted reads so clients do not need to join GET /v2/accounts by `account_id`. Balances are omitted — fetch the account directly for holdings. allOf: - $ref: '#/components/schemas/AccountTransferAccountDto' provider: type: object nullable: true example: hyperliquid description: >- Connection provider that produced this event. Null for on-chain-sourced rows (On-chain data provider ≠ Connection Provider). kind: type: string enum: - TRANSFER - TRADE example: TRADE description: 'Discriminator: which event-specific payload is populated.' status: type: string enum: - PENDING - CONFIRMED - FAILED example: CONFIRMED timestamp: type: string nullable: true example: '2026-01-15T10:00:00.000Z' description: Canonical event time (ISO 8601). hash: type: string nullable: true example: 0xabc... network: type: string nullable: true example: networks/ethereum-mainnet block_number: type: string nullable: true example: '21000000' direction: nullable: true enum: - in - out - internal type: string example: in description: >- Workspace-relative direction, judged on the first transfer leg against every saved account in the workspace (not narrowed by `group_ids`): `internal` when the counterparty is also a saved account or the leg is SELF, otherwise `in` / `out` from the leg. Null for trades and for transfers with no parsed legs. Unlike `transfers[].direction`, which is relative to the owning account. usd_amount: type: string nullable: true example: '250.50' description: >- 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. transfers: nullable: true description: >- Value movement legs. Populated when kind === 'TRANSFER' (may be empty when the provider has not parsed the underlying transfers yet). type: array items: $ref: '#/components/schemas/TransferEventDto' trade: nullable: true description: Populated when kind === 'TRADE'. type: object allOf: - $ref: '#/components/schemas/TradeEventDto' fee: nullable: true description: >- Network fee paid, in base units of the native asset. Present only for on-chain transactions on networks with indexed fee data (cosmos, stellar today); absent for CEX/bank connections, unsupported networks, or when the underlying transaction record has no fee. type: object allOf: - $ref: '#/components/schemas/TransactionFeeDto' category: type: string nullable: true example: Payroll description: >- User-assigned category label. Null when unset. Survives provider re-sync. note: type: string nullable: true example: Wire from payroll run description: User-authored note. Null when unset. Survives provider re-sync. raw: type: object additionalProperties: true example: {} description: >- Provider-native fields that are not part of the canonical shape (escape hatch; never relied upon by consumers). required: - id - account_id - kind - status - raw AccountTransferAccountDto: type: object properties: id: type: string example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 description: Stable account id. Matches `account_id` on the parent transfer. name: type: string example: Treasury wallet type: type: string example: eoa enum: - eoa - multisig - contract - custodian - exchange - bank - defi network: type: string nullable: true example: solana address: type: string nullable: true example: BJE5MMbqXjVwjAF7oxwPYXnTXDyspzZyt4vwenNw5ruG groups: type: array example: - id: uuid-1 name: Finance items: type: object properties: id: type: string name: type: string details: type: object description: >- Connection details when this account is linked to a Provider. Absent for standalone on-chain accounts. required: - id - name - type - groups TransferEventDto: type: object properties: direction: type: string enum: - IN - OUT - SELF example: IN asset: type: string nullable: true example: USDC amount: type: string nullable: true example: '100.50' description: Quantity moved, in asset units. usd_amount: type: string nullable: true example: '9.831' description: >- USD valuation at event time. Unsigned magnitude; direction conveys sign. source_address: type: string nullable: true example: 0xabc... destination_address: type: string nullable: true example: 0xdef... source_label: type: string nullable: true example: Coinbase description: >- Public or workspace label for `source_address`. Same overlay as `sender.label` on GET /v2/transfers: addresses.labels first, then the workspace's own name when one exists. source_malicious: type: boolean example: true description: >- True when `source_address` is labelled malicious in addresses.labels. source_icon_urls: example: - https://icons.range.org/icons/coinbase.webp description: Entity icon URLs for `source_address`, when known. type: array items: type: string destination_label: type: string nullable: true example: Treasury description: >- Public or workspace label for `destination_address`. Same overlay as `receiver.label` on GET /v2/transfers. destination_malicious: type: boolean example: false description: >- True when `destination_address` is labelled malicious in addresses.labels. destination_icon_urls: example: - https://icons.range.org/icons/entity.webp description: Entity icon URLs for `destination_address`, when known. type: array items: type: string required: - direction TradeEventDto: type: object properties: side: type: string enum: - BUY - SELL example: BUY base_asset: type: string nullable: true example: BTC base_amount: type: string nullable: true example: '0.01' quote_asset: type: string nullable: true example: USDC quote_amount: type: string nullable: true example: '500.0' description: Notional in quote asset units (price × base amount). price: type: string nullable: true example: '50000.0' fee: type: string nullable: true example: '0.45' fee_asset: type: string nullable: true example: USDC description: Asset the fee was charged in, when known. realized_pnl: type: string nullable: true example: '25.11' description: >- Realised PnL for a position-closing fill (perps). Null/absent for opens and spot. liquidation: type: boolean example: false description: >- True when the fill was a forced liquidation rather than a user-initiated trade. required: - side TransactionFeeDto: type: object properties: amount: type: string example: '5000' description: Fee paid, in base units of `denom`. denom: type: string example: uatom description: The network's native asset denom. required: - amount - denom securitySchemes: Authorization: type: apiKey in: header name: X-API-KEY description: Authorization method required to allow user to access the api endpoints. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.