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

# Get Onramp Transaction Status

> Get the current status of a specific onramp transaction by its ID



## OpenAPI

````yaml /api-reference/openapi.json get /payment/api/v1/onramp-audit/status/{transaction_id}
openapi: 3.0.0
info:
  title: Carbn Connect API
  version: 1.0.0
  description: >-
    API documentation for Carbn Connect services including user onboarding, KYC,
    wallet management, and transfers.
servers:
  - url: https://api.carbnconnect.com
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /payment/api/v1/onramp-audit/status/{transaction_id}:
    get:
      tags:
        - Audit & Reporting
      summary: Get Onramp Transaction Status
      description: Get the current status of a specific onramp transaction by its ID
      operationId: getOnrampTransactionStatus
      parameters:
        - name: transaction_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
          description: The unique identifier of the onramp transaction
      responses:
        '200':
          description: Onramp transaction status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OnrampStatusResponse'
        '400':
          description: Invalid request
        '401':
          description: Unauthorized - API key is missing or invalid
        '404':
          description: Transaction not found
      security:
        - ApiKeyAuth: []
components:
  schemas:
    OnrampStatusResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
          description: The unique identifier of the transaction
        currency:
          type: string
          example: eur
          description: Source currency (lowercase)
        status:
          type: string
          enum:
            - INITIATED
            - FUNDS_RECEIVED
            - PAYMENT_SUBMITTED
            - PAYMENT_PROCESSED
            - REFUND
          example: PAYMENT_PROCESSED
          description: >-
            Current status of the onramp transaction. INITIATED: Transaction has
            been started. FUNDS_RECEIVED: Funds have been received from the
            source. PAYMENT_SUBMITTED: Payment has been submitted to the
            destination. PAYMENT_PROCESSED: Payment has been fully processed.
            REFUND: Transaction has been refunded.
        sender_user_id:
          type: string
          format: uuid
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
          description: The unique identifier of the user who initiated the transaction
        source_amount:
          type: number
          example: 2
          description: Amount in source currency (fiat)
        destination_amount:
          type: number
          example: 2.34
          description: Amount in destination currency (crypto)
        wallet_txn_id:
          type: string
          example: >-
            4Hx6qtq21jNA4gZFHo51wTFtHWyj1Lwx6ii5kSQBHDkfQph5WP7XEpZDHqFFdALrtwbndQD74bfqta2oWFby8QTM
          description: Blockchain transaction ID/hash
        source_info:
          type: object
          properties:
            senderName:
              type: string
              example: John Doe
              description: Name of the sender
            bank_details:
              type: object
              properties:
                bic:
                  type: string
                  example: DEUTDEDBESS
                  description: Bank Identifier Code
                iban:
                  type: string
                  example: DE74360700240117179200
                  description: International Bank Account Number
                bank_name:
                  type: string
                  example: ''
                  description: Name of the bank
                payment_rail:
                  type: string
                  example: sepa
                  description: Payment rail used (sepa, swift, etc.)
            bank_txn_reference:
              type: string
              format: uuid
              example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
              description: Bank transaction reference ID
        wallet_details:
          type: object
          properties:
            crypto:
              type: string
              example: usdc
              description: Cryptocurrency type (lowercase)
            blockchain:
              type: string
              example: solana
              description: Blockchain network
            user_id:
              type: string
              format: uuid
              nullable: true
              example: null
              description: User ID associated with the wallet (can be null)
            wallet_id:
              type: string
              format: uuid
              example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
              description: Unique identifier of the destination wallet
            wallet_address:
              type: string
              example: 3BsSGETYNCjfULdgYEBVmzwXgaspS6E5pgncJr3bfBeU
              description: Blockchain wallet address
        funds_received_at:
          type: string
          format: date-time
          example: YYYY-MM-DDTHH:MM:SS.sssZ
          description: Timestamp when funds were received
        payment_submitted_at:
          type: string
          format: date-time
          example: YYYY-MM-DDTHH:MM:SS.sssZ
          description: Timestamp when payment was submitted
        payment_processed_at:
          type: string
          format: date-time
          example: YYYY-MM-DDTHH:MM:SS.sssZ
          description: Timestamp when payment was processed
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Must be included in the x-api-key header.

````