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

# Get invoice

> Retrieve a single invoice by its ID.



## OpenAPI

````yaml /api-reference/openapi.json get /invoices/{invoiceId}
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/{invoiceId}:
    get:
      tags:
        - Invoice Settlement
      summary: Get invoice
      description: Retrieve a single invoice by its ID.
      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: invoiceId
          in: path
          required: true
          schema:
            type: string
          description: The invoice ID
      responses:
        '200':
          description: Invoice details
          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
                  invoiceDocument: >-
                    https://res.cloudinary.com/afrivelle/image/upload/v1718000000/invoice_abc123.pdf
                  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
                  beneficiaryBankCountry: US
                  beneficiaryBankAddress: 123 Main Street, New York, NY 10001
                  beneficiaryName: Acme Corp
                  beneficiaryAddress: 456 Business Ave, San Francisco, CA 94105
                  beneficiaryCountryCode: US
                  beneficiaryCountryOfResidence: United States
                  swiftCode: FIBKUS33XXX
        '404':
          description: Invoice not found
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````