> ## 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 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.



## OpenAPI

````yaml /api-reference/platform-api.json get /v2/account-connections/transactions/{transactionId}
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.13
  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.
paths:
  /v2/account-connections/transactions/{transactionId}:
    get:
      tags:
        - Account Connections
      summary: Get a single connection transaction by id
      description: >-
        Fetches one persisted connection transaction by its transaction id (the
        `transaction_id` field returned by the list endpoints), scoped to the
        caller workspace.
      operationId: getConnectionTransactionById
      parameters:
        - name: transactionId
          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: 0x9a3f...
          description: Provider-native unique identifier for this event.
        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.
        account_id:
          type: string
          example: acc_abc123
          description: Account (in this API) the event belongs to.
        provider:
          type: object
          example: hyperliquid
          description: Connection provider that produced this event.
        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'
        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'
        category:
          type: string
          nullable: true
          example: Payroll
          description: >-
            User-assigned category label. 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
        - provider
        - kind
        - status
        - raw
    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...
      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
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````