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

# Get All Invoices

> Retrieve a list of invoices with optional filters like status, date range, or contact ID.

This endpoint fetches all invoices that belong to your organization. You can apply filters to narrow the results based on status, associated contact, time period, or internal tags.

### Common Use Cases

* Display a paginated invoice list in your dashboard
* Run financial or compliance reports
* Fetch invoices for a specific contact or period

You can also include metadata, pagination tokens, or sorting preferences using query parameters.


## OpenAPI

````yaml GET /invoices
openapi: 3.0.1
info:
  title: Antei API Reference
  description: >-
    Programmatic access to Antei’s platform. Use this API to manage core objects
    and retrieve taxation insights.
  version: 1.0.0
  license:
    name: MIT
  contact:
    name: Antei Developer Support
    email: support@antei.com
    url: https://antei.com
servers:
  - url: https://api.antei.com
security:
  - bearerAuth: []
paths:
  /invoices:
    get:
      summary: Get all invoices
      description: >-
        Retrieve a paginated list of invoices. You can filter by status,
        contact, or date range.
      parameters:
        - name: status
          in: query
          description: Filter invoices by status (e.g., draft, sent, paid, void)
          schema:
            type: string
        - name: contact_id
          in: query
          description: Filter invoices by contact/customer
          schema:
            type: string
        - name: start_date
          in: query
          description: Start of invoice issue date range (ISO 8601 format)
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          description: End of invoice issue date range (ISO 8601 format)
          schema:
            type: string
            format: date
        - name: limit
          in: query
          schema:
            type: integer
        - name: offset
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: List of invoices
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Invoice'
components:
  schemas:
    Invoice:
      type: object
      properties:
        id:
          type: string
        invoice_number:
          type: string
        status:
          type: string
          enum:
            - draft
            - sent
            - paid
            - void
        contact_id:
          type: string
        transaction_ids:
          type: array
          items:
            type: string
        currency:
          type: string
        amount:
          type: number
          format: float
        issue_date:
          type: string
          format: date
        due_date:
          type: string
          format: date
        metadata:
          type: object
          additionalProperties:
            type: string
      required:
        - invoice_number
        - contact_id
        - status
        - currency
        - amount
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````