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

# Track transaction by reference



## OpenAPI

````yaml /openapi.json get /api/v1/offramp/ledger/status/{reference}
openapi: 3.0.0
info:
  title: Mr Monei API Gateway
  description: External API for partners using API Key authentication
  version: '1.0'
  contact: {}
servers:
  - url: https://api.dev.monei.cc
    description: Dev Server
  - url: https://api.monei.cc
    description: Live Server
security: []
tags: []
paths:
  /api/v1/offramp/ledger/status/{reference}:
    get:
      tags:
        - Offramp | Ledger
      summary: Track transaction by reference
      operationId: OfframpLedgerController_getByReference
      parameters:
        - name: reference
          required: true
          in: path
          schema:
            example: OFF-A1B2C
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OfframpTransactionDetailResponseDto'
      security:
        - bearer: []
        - api-key: []
components:
  schemas:
    OfframpTransactionDetailResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Transaction ID
          example: 123e4567-e89b-12d3-a456-426614174000
        internalReference:
          type: string
          description: Internal reference number
          example: OFF-A1B2C3D4
        provider:
          type: string
          description: Exchange provider
          enum:
            - monirates
            - bitnob
            - paycrest
          example: monirates
        providerTransactionId:
          type: string
          description: Provider transaction ID
          example: 68ee3a94c05777e37c10b3c1
        status:
          type: string
          description: Current transaction status
          enum:
            - initiated
            - quote_created
            - awaiting_deposit
            - deposit_received
            - pending
            - processing
            - fiat_sent
            - completed
            - failed
            - cancelled
            - refunded
          example: processing
        cryptoAmount:
          type: number
          description: Cryptocurrency amount
          example: 100
        fiatAmount:
          type: number
          description: Fiat currency amount
          example: 145800
        exchangeRate:
          type: number
          description: Exchange rate applied
          example: 1458
        fromCurrency:
          type: string
          description: From currency
          example: USDT
        toCurrency:
          type: string
          description: To currency
          example: NGN
        createdAt:
          format: date-time
          type: string
          description: Transaction creation timestamp
          example: '2025-10-14T11:57:08.122Z'
        updatedAt:
          format: date-time
          type: string
          description: Transaction last update timestamp
          example: '2025-10-14T11:57:09.065Z'
        expiresAt:
          format: date-time
          type: string
          description: Transaction expiry timestamp
          example: '2025-10-14T12:27:08.122Z'
        providerStatus:
          type: string
          description: Provider status
          example: PROCESSING
        fees:
          type: object
          description: Transaction fees
          example:
            providerFee: 0.01
            networkFee: 0.0015
            serviceFee: 0.005
        debitPaymentDetails:
          type: object
          description: Debit payment details
          example:
            paymentMethod: STABLE_CURRENCY
            currency: USDT
            network: BEP20
            walletAddress: '0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1'
        creditPaymentDetails:
          type: object
          description: Credit payment details
          example:
            paymentMethod: BANK_TRANSFER
            currency: NGN
            accountName: John Doe
            accountNumber: '0115847370'
            bankCode: '999240'
        completedAt:
          format: date-time
          type: string
          description: Transaction completion timestamp
          example: '2025-10-14T12:00:00.000Z'
          nullable: true
      required:
        - id
        - internalReference
        - provider
        - providerTransactionId
        - status
        - cryptoAmount
        - fiatAmount
        - exchangeRate
        - fromCurrency
        - toCurrency
        - createdAt
        - updatedAt
        - expiresAt
        - providerStatus
        - fees
        - debitPaymentDetails
        - creditPaymentDetails
        - completedAt
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-KEY

````