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

# List invoices

> Returns invoices for your organization, newest first by creation time. Supports status filtering and offset pagination.



## OpenAPI

````yaml /api-reference/openapi.json get /invoices
openapi: 3.1.0
info:
  title: Karat Payout API
  description: >-
    Your gateway to seamless, automated, and scalable payment solutions. The
    Karat Payout API lets you create recipients, send payouts, track payment
    status, manage tax documents and invoices, record external payments, and
    subscribe to webhook events.
  version: 1.0.0
servers:
  - url: https://payouts.api.trykarat.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Retrieve payout source accounts, balances, and payout totals.
  - name: Payments
    description: Create and manage outgoing payouts to recipients.
  - name: Recipients
    description: Manage the payees you send payouts to.
  - name: Tax
    description: Retrieve recipient tax forms (W-9) and download links.
  - name: External Payments
    description: Record and manage payments made outside of Karat.
  - name: Webhooks
    description: Subscribe to event notifications for payout activity.
  - name: Invoices
    description: >-
      Create, list, retrieve, cancel, and send reminders for invoices; retrieve
      temporary PDF links.
paths:
  /invoices:
    get:
      tags:
        - Invoices
      summary: List invoices
      description: >-
        Returns invoices for your organization, newest first by creation time.
        Supports status filtering and offset pagination.
      operationId: listInvoices
      parameters:
        - name: limit
          in: query
          description: Page size; values above 100 are clamped to 100.
          schema:
            type: integer
            minimum: 1
            default: 100
        - $ref: '#/components/parameters/Offset'
        - name: status
          in: query
          schema:
            $ref: '#/components/schemas/InvoiceStatus'
      responses:
        '200':
          description: List invoices.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Invoice'
                  meta:
                    $ref: '#/components/schemas/PaginationMeta'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    Offset:
      name: offset
      in: query
      description: Number of results to skip for pagination (default 0).
      required: false
      schema:
        type: integer
        minimum: 0
        default: 0
  schemas:
    InvoiceStatus:
      type: string
      enum:
        - open
        - paid
        - paid_via_stripe
        - overdue
        - cancelled
    Invoice:
      type: object
      required:
        - id
        - invoiceNumber
        - status
        - recipient
        - total
        - paidAmount
        - lineItems
        - invoiceDate
        - dueDate
        - poNumber
        - payerMemo
        - paymentInstructions
        - paymentAccount
        - automaticReconciliationEnabled
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
        invoiceNumber:
          type: string
        status:
          $ref: '#/components/schemas/InvoiceStatus'
        recipient:
          type: object
          required:
            - id
            - name
            - email
          properties:
            id:
              type:
                - string
                - 'null'
              format: uuid
            name:
              type: string
            email:
              type: string
              format: email
        total:
          type: integer
          description: Amount in cents.
        paidAmount:
          type: integer
          description: Amount in cents.
        lineItems:
          type: array
          items:
            type: object
            required:
              - description
              - quantity
              - unitPrice
              - amount
            properties:
              description:
                type: string
              quantity:
                type: integer
              unitPrice:
                type: integer
                description: Amount in cents.
              amount:
                type: integer
                description: Amount in cents.
        invoiceDate:
          type: string
          format: date
        dueDate:
          type: string
          format: date
        poNumber:
          type:
            - string
            - 'null'
        payerMemo:
          type:
            - string
            - 'null'
        paymentInstructions:
          type:
            - string
            - 'null'
        paymentAccount:
          oneOf:
            - type: object
              required:
                - accountNumber
                - routingNumber
              properties:
                accountNumber:
                  type: string
                routingNumber:
                  type: string
            - type: 'null'
        automaticReconciliationEnabled:
          type: boolean
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    PaginationMeta:
      type: object
      properties:
        total:
          type: integer
          description: Total number of matching records.
        limit:
          type: integer
        offset:
          type: integer
    Error:
      type: object
      description: Standard error envelope returned for all non-2xx responses.
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
          required:
            - message
      required:
        - error
  responses:
    BadRequest:
      description: The request was invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: 'amount: amount must be positive'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Invalid api key
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Pass your API key as a bearer token: `Authorization: Bearer <API_KEY>`.'

````