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

# List invoices

> This endpoint allows fetching a list of invoice summaries.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/invoices/
openapi: 3.1.0
info:
  title: API Reference
  version: '1.0'
  description: Aira API Reference
  x-logo:
    url: https://static.useaira.com/images/airalogo.svg
    backgroundColor: '#FFFFFF'
    altText: Aira Logo
servers:
  - url: https://api.useaira.com
    description: API base URL
security:
  - ApiKey: []
paths:
  /v1/invoices/:
    get:
      tags:
        - Invoices
      summary: List invoices
      description: This endpoint allows fetching a list of invoice summaries.
      parameters:
        - schema:
            type: string
          in: query
          name: search
          required: false
        - schema:
            type: array
            items:
              type: string
              format: uuid
          in: query
          name: customerIds[]
          required: false
        - schema:
            type: array
            items:
              type: string
              enum:
                - open
                - in_review
                - issued
                - synced
                - pending
                - paid
                - overdue
                - canceled
                - failed
          in: query
          name: status[]
          required: false
        - schema:
            type: boolean
            default: false
          in: query
          name: includeCanceled
          required: false
        - schema:
            type: boolean
            default: false
          in: query
          name: hideZeroAmount
          required: false
        - schema:
            type: string
            format: date
          in: query
          name: invoiceDate.gte
          required: false
        - schema:
            type: string
            format: date
          in: query
          name: invoiceDate.lte
          required: false
        - schema:
            type: number
            default: 0
            minimum: 0
          in: query
          name: offset
          required: false
        - schema:
            type: number
            minimum: 1
            default: 100
            maximum: 100
          in: query
          name: limit
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        customer:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                            externalId:
                              type: string
                          required:
                            - id
                            - name
                            - externalId
                          additionalProperties: false
                        billingAccount:
                          type: object
                          properties:
                            businessName:
                              type: string
                            taxId:
                              type: string
                            taxIdType:
                              type: string
                              enum:
                                - cnpj
                                - cpf
                          required:
                            - businessName
                            - taxId
                            - taxIdType
                          additionalProperties: false
                        invoiceNumber:
                          type: string
                        invoiceDate:
                          type: string
                          format: date
                        dueDate:
                          type: string
                          format: date
                          nullable: true
                        totalAmount:
                          type: number
                        status:
                          type: string
                          enum:
                            - open
                            - in_review
                            - issued
                            - synced
                            - pending
                            - paid
                            - overdue
                            - canceled
                            - failed
                      required:
                        - id
                        - customer
                        - billingAccount
                        - invoiceNumber
                        - invoiceDate
                        - dueDate
                        - totalAmount
                        - status
                      additionalProperties: false
                    description: A list of items.
                  hasMore:
                    description: Indicates if there are more items to fetch.
                    type: boolean
                required:
                  - items
                  - hasMore
                additionalProperties: false
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      description: API Key Authentication.
      name: X-API-KEY
      in: header

````