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

# Get transaction history



## OpenAPI

````yaml /openapi.json get /api/v1/offramp/ledger/history
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/history:
    get:
      tags:
        - Offramp | Ledger
      summary: Get transaction history
      operationId: OfframpLedgerController_getHistory
      parameters:
        - name: limit
          required: false
          in: query
          schema:
            type: number
        - name: page
          required: false
          in: query
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OfframpTransactionListResponseDto'
      security:
        - bearer: []
        - api-key: []
components:
  schemas:
    OfframpTransactionListResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code
          example: 200
        message:
          type: string
          description: Response message
          example: Transactions retrieved successfully
        data:
          description: List of transactions
          type: array
          items:
            $ref: '#/components/schemas/OfframpTransactionResponseDto'
        meta:
          type: object
          description: Pagination metadata
          example:
            total: 15
            page: 1
            limit: 10
            totalPages: 2
      required:
        - statusCode
        - message
        - data
        - meta
    OfframpTransactionResponseDto:
      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'
      required:
        - id
        - internalReference
        - provider
        - providerTransactionId
        - status
        - cryptoAmount
        - fiatAmount
        - exchangeRate
        - fromCurrency
        - toCurrency
        - createdAt
        - updatedAt
        - expiresAt
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-KEY

````