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

# List my invoices

> Returns a paginated list of invoices.



## OpenAPI

````yaml /api-reference/openapi.json get /invoices/me
openapi: 3.0.0
info:
  title: Obiex API
  version: 1.0.0
  description: >-
    Welcome to the Obiex API Documentation, your guide to building amazing
    payment experiences with our powerful APIs.


    Start by reviewing the overview of each folder to understand how the APIs
    function and interact. This will help you get the most out of our platform
    and easily integrate its features into your applications.
servers:
  - url: https://api.obiex.finance/v1
security: []
paths:
  /invoices/me:
    get:
      tags:
        - Invoice Settlement
      summary: List my invoices
      description: Returns a paginated list of invoices.
      parameters:
        - name: x-api-key
          in: header
          required: false
          deprecated: false
          schema: {}
        - name: x-api-signature
          in: header
          required: false
          deprecated: false
          schema: {}
        - name: x-api-timestamp
          in: header
          required: false
          deprecated: false
          schema: {}
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - PENDING
              - APPROVED
              - PROCESSING
              - COMPLETED
              - FAILED
              - EXPIRED
              - REFUNDED
          description: Filter by invoice status
        - name: startDate
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Filter invoices created on or after this date
        - name: endDate
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Filter invoices created on or before this date
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
        - name: pageSize
          in: query
          required: false
          schema:
            type: integer
            default: 30
      responses:
        '200':
          description: Paginated list of invoices
          content:
            application/json:
              schema:
                type: object
              example:
                message: Ok
                data:
                  - id: a3f1c2d4-8b0e-4f3a-9c7d-1e2b3a4c5d6e
                    createdAt: '2026-06-10T11:00:00.000Z'
                    updatedAt: '2026-06-10T12:45:00.000Z'
                    status: COMPLETED
                    sourceCurrency: NGN
                    sourceAmount: 1625000
                    targetCurrency: USD
                    targetAmount: 1000
                    rate: 1625
                    purposeOfPayment: Payment for software development services
                    virtualAccountNumber: '9012345678'
                    virtualAccountName: Obiex / Acme Corp
                    virtualBankName: Providus Bank
                    virtualAccountReference: INV-REF-2026-001
                    accountExpiresAt: '2026-06-10T11:30:00.000Z'
                    trackingId: TRK-20260610-001
                    beneficiaryAccountNumber: '12345678901'
                    beneficiaryAccountName: Acme Corp Account
                    beneficiaryBankName: First International Bank
                    swiftCode: FIBKUS33XXX
                meta:
                  page: 1
                  pageSize: 30
                  total: 1
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````