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

# Get All Transactions

> Retrieve paginated onramp and/or offramp transactions for your business. Supports filtering by transaction type, status (Completed, Failed, Cancelled), and date range. Results are sorted newest first.



## OpenAPI

````yaml /reference/link-transaction.json get /transactions/v2/fetch_all_transactions
openapi: 3.1.0
info:
  title: link-transaction
  version: '1.0'
servers:
  - url: https://api.linkio.world
security:
  - sec0: []
tags:
  - name: Direct FX
  - name: Pan-Africa Ramp
  - name: BRL Ramp
  - name: IDR Ramp
  - name: B2B
  - name: Customers
  - name: Static Details
  - name: Transactions
  - name: Accounts
  - name: ESPESS
paths:
  /transactions/v2/fetch_all_transactions:
    get:
      tags:
        - Transactions
      summary: Get All Transactions
      description: >-
        Retrieve paginated onramp and/or offramp transactions for your business.
        Supports filtering by transaction type, status (Completed, Failed,
        Cancelled), and date range. Results are sorted newest first.
      operationId: fetch_transactions
      parameters:
        - name: type
          in: query
          required: false
          description: >-
            Filter by transaction direction. Omit to return both onramp and
            offramp transactions.
          schema:
            type: string
            enum:
              - onramp
              - offramp
        - name: page
          in: query
          required: false
          description: Page number (1-based). Defaults to 1.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: limit
          in: query
          required: false
          description: Number of transactions per page. Defaults to 20, maximum 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: status
          in: query
          required: false
          description: >-
            Filter by transaction status. Omit to return transactions of all
            statuses.
          schema:
            type: string
            enum:
              - Completed
              - Failed
              - Cancelled
        - name: from
          in: query
          required: false
          description: Start of date range (ISO 8601, e.g. 2026-01-01). Inclusive.
          schema:
            type: string
            format: date
            example: '2026-01-01'
        - name: to
          in: query
          required: false
          description: >-
            End of date range (ISO 8601, e.g. 2026-06-30). Inclusive — covers
            the full day up to 23:59:59.
          schema:
            type: string
            format: date
            example: '2026-06-30'
      responses:
        '200':
          description: Transactions retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: Success
                  message:
                    type: string
                    example: Transactions retrieved.
                  summary:
                    type: object
                    properties:
                      total_transactions:
                        type: integer
                        example: 150
                        description: >-
                          Total transactions matching the date and status
                          filters (both directions).
                      total_deposits:
                        type: integer
                        example: 90
                        description: Onramp transactions within the applied filters.
                      total_withdrawals:
                        type: integer
                        example: 60
                        description: Offramp transactions within the applied filters.
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        business_id:
                          type: string
                        transaction_reference:
                          type: string
                          example: link-otc-12345678
                        transaction_type:
                          type: string
                          enum:
                            - onramp
                            - offramp
                        amount:
                          type: number
                        currency:
                          type: string
                          example: NGN
                        stable:
                          type: string
                          example: USDC
                        payout_amount:
                          type: number
                        rate:
                          type: number
                        payment_method:
                          type: string
                          example: NIP
                        transaction_status:
                          type: string
                          example: pending
                        transaction_date:
                          type: string
                          example: June 05, 2026 14:30:00
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                        example: 347
                        description: Total matching transactions across all pages.
                      page:
                        type: integer
                        example: 1
                      limit:
                        type: integer
                        example: 20
                      total_pages:
                        type: integer
                        example: 18
        '400':
          description: Invalid query parameter (e.g. malformed date).
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: Failed
                  message:
                    type: string
                    example: Invalid 'from' date.
        '500':
          description: Internal server error.
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: ngnc-sec-key
      x-default: ''

````