> ## Documentation Index
> Fetch the complete documentation index at: https://docs.business.blaaiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get transaction

> Retrieve a completed API transaction by its transaction ID or reference. Required scope: `transaction:read`.



## OpenAPI

````yaml /api-reference/transaction/get-openapi.json get /api/external/transaction/{id}
openapi: 3.1.0
info:
  title: Blaaiz Platform API - Get Transaction
  version: 1.0.0
  description: >-
    Retrieve details of a completed API transaction. Transaction responses now
    include `swap_details` for swap transactions.
servers:
  - url: https://api-prod.blaaiz.com
  - url: https://api-dev.blaaiz.com
security: []
tags:
  - name: Transaction
paths:
  /api/external/transaction/{id}:
    get:
      tags:
        - Transaction
      summary: Get transaction
      description: >-
        Retrieve a completed API transaction by its transaction ID or reference.
        Required scope: `transaction:read`.
      parameters:
        - name: id
          in: path
          required: true
          description: Unique transaction ID or transaction reference.
          schema:
            type: string
      responses:
        '200':
          description: Transaction retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionResponse'
              examples:
                Payout:
                  value:
                    message: Transaction retrieved successfully
                    data:
                      id: txn_payout_001
                      business_id: business_123
                      business_customer_id: customer_123
                      business_wallet_id: wallet_ngn_001
                      status: SUCCESSFUL
                      type: payout
                      reference: payout_ref_001
                      currency: NGN
                      amount: 50000
                      amount_without_fee: 49500
                      fee: 500
                      rate: null
                      date: '2026-03-13T10:30:00.000000Z'
                      payee_collection_email: null
                      source_information:
                        collection_email: null
                        collection_name: null
                      swap_details: null
                      recipient:
                        id: recipient_123
                        account_number: '0123456789'
                        account_name: John Doe
                        amount: 50000
                        currency: NGN
                        bank_name: Access Bank
                        bank_code: '044'
                        status: SUCCESSFUL
                        routing_number: null
                        email: null
                Collection:
                  value:
                    message: Transaction retrieved successfully
                    data:
                      id: txn_collection_001
                      business_id: business_123
                      business_customer_id: customer_123
                      business_wallet_id: wallet_ngn_001
                      status: SUCCESSFUL
                      type: collection
                      reference: collection_ref_001
                      currency: NGN
                      amount: 50000
                      amount_without_fee: 50000
                      fee: 0
                      rate: null
                      date: '2026-03-13T09:10:00.000000Z'
                      payee_collection_email: customer@company.com
                      source_information:
                        collection_email: collections@blaaiz.com
                        collection_name: John Doe
                      swap_details: null
                      recipient: null
                Swap:
                  value:
                    message: Transaction retrieved successfully
                    data:
                      id: txn_swap_001
                      business_id: business_123
                      business_customer_id: null
                      business_wallet_id: wallet_usd_001
                      status: SUCCESSFUL
                      type: swap
                      reference: swap_ref_001
                      currency: USD
                      amount: 100
                      amount_without_fee: 99
                      fee: 1
                      rate: null
                      date: '2026-03-13T11:45:00.000000Z'
                      payee_collection_email: null
                      source_information:
                        collection_email: null
                        collection_name: null
                      swap_details:
                        from_business_wallet_id: wallet_usd_001
                        to_business_wallet_id: wallet_ngn_001
                        from_currency: USD
                        from_amount: 100
                        from_amount_without_fee: 99
                        to_currency: NGN
                        to_amount: 160000
                        amount_type: from
                        exchange_rate: 1600
                      recipient: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Invalid or missing access token
        '404':
          description: Transaction not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Transaction not found.
      security:
        - oauth2ClientCredentials:
            - transaction:read
components:
  schemas:
    TransactionResponse:
      type: object
      properties:
        message:
          type: string
        data:
          $ref: '#/components/schemas/Transaction'
      required:
        - message
        - data
    Error:
      type: object
      properties:
        message:
          type: string
      required:
        - message
    Transaction:
      type: object
      properties:
        id:
          type: string
          description: Transaction ID.
        business_id:
          type: string
          description: Business ID.
        business_customer_id:
          type:
            - string
            - 'null'
          description: Business customer ID when the transaction is tied to a customer.
        business_wallet_id:
          type:
            - string
            - 'null'
          description: Primary business wallet ID recorded on the transaction.
        status:
          type: string
          description: Transaction status.
        type:
          type: string
          description: >-
            Normalized transaction type returned by the API. Possible values are
            `collection`, `payout`, and `swap`.
        reference:
          type: string
          description: Transaction reference.
        currency:
          type:
            - string
            - 'null'
          description: Source currency for the transaction.
        amount:
          type:
            - number
            - 'null'
          description: Gross transaction amount.
        amount_without_fee:
          type:
            - number
            - 'null'
          description: Net transaction amount after fees.
        fee:
          type:
            - number
            - 'null'
          description: Transaction fee.
        rate:
          type:
            - number
            - 'null'
          description: Recipient exchange rate for payout transactions.
        date:
          type: string
          format: date-time
          description: Transaction creation timestamp.
        payee_collection_email:
          type:
            - string
            - 'null'
          description: Payee collection email for Interac transactions, when applicable.
        source_information:
          $ref: '#/components/schemas/SourceInformation'
        swap_details:
          oneOf:
            - $ref: '#/components/schemas/SwapDetails'
            - type: 'null'
        recipient:
          oneOf:
            - $ref: '#/components/schemas/Recipient'
            - type: 'null'
      required:
        - id
        - business_id
        - business_customer_id
        - business_wallet_id
        - status
        - type
        - reference
        - currency
        - amount
        - amount_without_fee
        - fee
        - rate
        - date
        - payee_collection_email
        - source_information
        - swap_details
        - recipient
    SourceInformation:
      type: object
      properties:
        collection_email:
          type:
            - string
            - 'null'
          description: Collection email used for Interac collections, when applicable.
        collection_name:
          type:
            - string
            - 'null'
          description: Name of the sender for Interac collections, when available.
    SwapDetails:
      type: object
      properties:
        from_business_wallet_id:
          type: string
        to_business_wallet_id:
          type: string
        from_currency:
          type: string
        from_amount:
          type: number
        from_amount_without_fee:
          type: number
        to_currency:
          type: string
        to_amount:
          type: number
        amount_type:
          type: string
          enum:
            - from
            - to
        exchange_rate:
          type:
            - number
            - 'null'
      required:
        - from_business_wallet_id
        - to_business_wallet_id
        - from_currency
        - from_amount
        - from_amount_without_fee
        - to_currency
        - to_amount
        - amount_type
        - exchange_rate
    Recipient:
      type: object
      properties:
        id:
          type: string
        account_number:
          type: string
        account_name:
          type: string
        amount:
          type: number
        currency:
          type: string
        bank_name:
          type: string
        bank_code:
          type: string
        status:
          type:
            - string
            - 'null'
        routing_number:
          type:
            - string
            - 'null'
        email:
          type:
            - string
            - 'null'
  securitySchemes:
    oauth2ClientCredentials:
      type: oauth2
      description: >-
        Use your OAuth client credentials to obtain a short-lived Bearer token
        from POST /oauth/token.
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            transaction:read: Read transactions.

````