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

# List Invoices

> Returns the merchant's invoices, paginated, newest first.



## OpenAPI

````yaml GET /invoices
openapi: 3.0.0
info:
  title: Ebioro Merchant API
  description: >-
    API for merchant payment processing on Stellar. Supports direct USDC
    payments and cross-chain deposits from multiple blockchains.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /invoices:
    get:
      tags:
        - Invoices
      summary: List invoices
      description: Returns the merchant's invoices, paginated, newest first.
      operationId: InvoicesController_list
      parameters:
        - name: x-digest-timestamp
          in: header
          description: Current Unix timestamp
          required: true
          schema:
            type: string
        - name: x-digest-key
          in: header
          description: Your public api key
          required: true
          schema:
            type: string
        - name: x-digest-signature
          in: header
          description: Digest Auth Signature
          required: true
          schema:
            type: string
        - name: page
          required: false
          in: query
          schema:
            type: number
            default: 1
        - name: limit
          required: false
          in: query
          schema:
            type: number
            default: 20
            maximum: 100
      responses:
        '200':
          description: Paginated list of invoices.
          content:
            application/json:
              example:
                items:
                  - id: c9310d0f-6338-4780-b8d2-6a125e258a4a
                    invoice_number: INV-2026-4
                    status: sent
                    currency: USD
                    line_items:
                      - description: Consulting — June
                        quantity: 2
                        unit_price: 10000
                    subtotal: 20000
                    tax_percentage: 21
                    tax_total: 4200
                    total: 24200
                    issued_at: '2026-06-10T15:24:48.801Z'
                    due_at: null
                    payment_id: pt_EL1yKOzKdv
                    notes: Thanks for your business.
                    customer:
                      id: 9c4749b3-8f18-4a25-9d67-8b1866d6c56d
                      customer_type: business
                      name: null
                      company_name: Example Co B.V.
                      email: billing@example.com
                      vat_number: null
                      address: null
                    createdAt: '2026-06-10T15:24:48.791Z'
                    updatedAt: '2026-06-10T15:24:48.866Z'
                meta:
                  totalItems: 1
                  itemCount: 1
                  itemsPerPage: 20
                  totalPages: 1
                  currentPage: 1
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/InvoiceDto'
                  meta:
                    type: object
        '401':
          description: Authentication failed.
          content:
            application/json:
              example:
                reason: Signature verification failed
                statusCode: 401
        '404':
          description: Not found (or owned by another merchant).
          content:
            application/json:
              example:
                reason: Not found
                statusCode: 404
      security:
        - customHeader: []
components:
  schemas:
    InvoiceDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
        invoice_number:
          type: string
          example: INV-2026-4
        status:
          type: string
          enum:
            - draft
            - sent
            - paid
            - overdue
            - voided
          example: sent
        currency:
          type: string
          example: USD
        line_items:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceLineItemDto'
        subtotal:
          type: integer
          example: 20000
          description: Subtotal in the smallest currency unit (cents).
        tax_percentage:
          type: number
          example: 21
        tax_total:
          type: integer
          example: 4200
          description: Tax amount in cents.
        total:
          type: integer
          example: 24200
          description: Total in cents.
        issued_at:
          type: string
          format: date-time
          nullable: true
        due_at:
          type: string
          format: date-time
          nullable: true
        payment_id:
          type: string
          example: pt_EL1yKOzKdv
          description: >-
            id of the linked payment. Fetch it via GET /payments/{id} to obtain
            the shareable payment link (shortUrl / hostedUrl).
        notes:
          type: string
          nullable: true
        customer:
          type: object
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    InvoiceLineItemDto:
      type: object
      properties:
        description:
          type: string
          example: Consulting — June
        quantity:
          type: integer
          example: 2
          description: Quantity (whole units).
        unit_price:
          type: integer
          example: 10000
          description: Unit price in the smallest unit of the currency (e.g. cents).
      required:
        - description
        - quantity
        - unit_price
  securitySchemes:
    customHeader:
      type: apiKey
      in: header
      name: x-digest-key
      description: Your public API key

````