---
title: "Get invoices"
method: GET
path: "/api/v2/invoices"
tags: ["Invoices"]
---

# Get invoices

`GET /api/v2/invoices`

List invoices.

## Query parameters

- `filter` union — Filter schema for `invoice` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterInvoice — Available filter parameters for querying invoices.
    - `amount_paid` union — Amount already paid (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter amount_paid using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` AmountPaid — unresolved $ref
        - `not_contain` AmountPaid — unresolved $ref
        - `not_eq` AmountPaid — unresolved $ref
        - `eq` AmountPaid — unresolved $ref
      - AmountPaid — unresolved $ref
    - `amount_credited` union — Amount credited via credit notes, excluding tax (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - AmountCredited — unresolved $ref
      - object — Filter amount_credited using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` AmountCredited — unresolved $ref
        - `not_contain` AmountCredited — unresolved $ref
        - `contains` AmountCredited — unresolved $ref
        - `eq` AmountCredited — unresolved $ref
    - `issuer_id` union — Issuer person ID. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter issuer_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` IssuerId — unresolved $ref
        - `not_contain` IssuerId — unresolved $ref
        - `eq` IssuerId — unresolved $ref
        - `not_eq` IssuerId — unresolved $ref
      - IssuerId — unresolved $ref
    - `fuzzy_people` union — Fuzzy people search across person-related fields. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter fuzzy_people using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
        - `not_eq` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
      - FuzzyPeople — unresolved $ref
    - `credited` union — Whether this invoice has been credited. Supports filtering by exact match, exclusion, and containment operators.
      - Credited — unresolved $ref
      - object — Filter credited using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` Credited — unresolved $ref
        - `eq` Credited — unresolved $ref
        - `not_eq` Credited — unresolved $ref
        - `contains` Credited — unresolved $ref
    - `last_activity_at` union — Date of last activity on this invoice. Supports filtering by exact match, exclusion, and containment operators.
      - LastActivityAt — unresolved $ref
      - object — Filter last_activity_at using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` LastActivityAt — unresolved $ref
        - `not_contain` LastActivityAt — unresolved $ref
        - `not_eq` LastActivityAt — unresolved $ref
        - `contains` LastActivityAt — unresolved $ref
    - `amount_credited_with_tax` union — Amount credited including tax (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - AmountCreditedWithTax — unresolved $ref
      - object — Filter amount_credited_with_tax using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` AmountCreditedWithTax — unresolved $ref
        - `not_contain` AmountCreditedWithTax — unresolved $ref
        - `contains` AmountCreditedWithTax — unresolved $ref
        - `not_eq` AmountCreditedWithTax — unresolved $ref
    - `invoice_status` union — Invoice payment status. Supports filtering by exact match, exclusion, and containment operators.
      - InvoiceStatus — unresolved $ref
      - object — Filter invoice_status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` InvoiceStatus — unresolved $ref
        - `not_eq` InvoiceStatus — unresolved $ref
        - `contains` InvoiceStatus — unresolved $ref
        - `not_contain` InvoiceStatus — unresolved $ref
    - `automatically_created` union — Whether the invoice was automatically generated from a template. Supports filtering by exact match, exclusion, and containment operators.
      - AutomaticallyCreated — unresolved $ref
      - object — Filter automatically_created using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` AutomaticallyCreated — unresolved $ref
        - `not_contain` AutomaticallyCreated — unresolved $ref
        - `eq` AutomaticallyCreated — unresolved $ref
        - `not_eq` AutomaticallyCreated — unresolved $ref
    - `full_query` union — Full-text search across invoice fields. Supports filtering by exact match, exclusion, and containment operators.
      - FullQuery — unresolved $ref
      - object — Filter full_query using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` FullQuery — unresolved $ref
        - `contains` FullQuery — unresolved $ref
        - `not_eq` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
    - `overdue_status` union — Overdue status of the invoice. Supports filtering by exact match, exclusion, and containment operators.
      - OverdueStatus — unresolved $ref
      - object — Filter overdue_status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` OverdueStatus — unresolved $ref
        - `contains` OverdueStatus — unresolved $ref
        - `eq` OverdueStatus — unresolved $ref
        - `not_contain` OverdueStatus — unresolved $ref
    - `query` union — Search term across invoice text fields. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter query using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
      - Query — unresolved $ref
    - `invoice_type` union — Invoice type (standard invoice or credit note). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter invoice_type using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` InvoiceType — unresolved $ref
        - `not_eq` InvoiceType — unresolved $ref
        - `eq` InvoiceType — unresolved $ref
        - `contains` InvoiceType — unresolved $ref
      - InvoiceType — unresolved $ref
    - `sent_status` union — Sent status of the invoice. Supports filtering by exact match, exclusion, and containment operators.
      - SentStatus — unresolved $ref
      - object — Filter sent_status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` SentStatus — unresolved $ref
        - `not_eq` SentStatus — unresolved $ref
        - `eq` SentStatus — unresolved $ref
        - `contains` SentStatus — unresolved $ref
    - `currency` union — Invoice currency code. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter currency using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` Currency — unresolved $ref
        - `not_contain` Currency — unresolved $ref
        - `not_eq` Currency — unresolved $ref
        - `contains` Currency — unresolved $ref
      - Currency — unresolved $ref
    - `subsidiary_id` union — Issuing subsidiary ID. Supports filtering by exact match, exclusion, and containment operators.
      - SubsidiaryId — unresolved $ref
      - object — Filter subsidiary_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` SubsidiaryId — unresolved $ref
        - `not_eq` SubsidiaryId — unresolved $ref
        - `eq` SubsidiaryId — unresolved $ref
        - `contains` SubsidiaryId — unresolved $ref
    - `sent_on` union — Date when the invoice was sent to the client. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter sent_on using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` SentOn — unresolved $ref
        - `not_eq` SentOn — unresolved $ref
        - `contains` SentOn — unresolved $ref
        - `not_contain` SentOn — unresolved $ref
      - SentOn — unresolved $ref
    - `amount` union — Invoice amount excluding tax (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - Amount — unresolved $ref
      - object — Filter amount using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` Amount — unresolved $ref
        - `not_contain` Amount — unresolved $ref
        - `eq` Amount — unresolved $ref
        - `contains` Amount — unresolved $ref
    - `payment_terms` union — Number of days between invoice issue date and due date. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter payment_terms using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` PaymentTerms — unresolved $ref
        - `not_contain` PaymentTerms — unresolved $ref
        - `eq` PaymentTerms — unresolved $ref
        - `contains` PaymentTerms — unresolved $ref
      - PaymentTerms — unresolved $ref
    - `parent_company_id` union — Filter by the parent company of the invoice's company.
      - ParentCompanyId — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_contain` ParentCompanyId — unresolved $ref
        - `contains` ParentCompanyId — unresolved $ref
        - `eq` ParentCompanyId — unresolved $ref
        - `not_eq` ParentCompanyId — unresolved $ref
    - `export_status` union — Export status to external accounting software. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter export_status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` ExportStatus — unresolved $ref
        - `contains` ExportStatus — unresolved $ref
        - `eq` ExportStatus — unresolved $ref
        - `not_contain` ExportStatus — unresolved $ref
      - ExportStatus — unresolved $ref
    - `custom_fields` union — Custom field values. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter custom_fields using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` CustomFields — unresolved $ref
        - `not_eq` CustomFields — unresolved $ref
        - `eq` CustomFields — unresolved $ref
        - `not_contain` CustomFields — unresolved $ref
      - CustomFields — unresolved $ref
    - `deal_id` union — Budget (deal) ID. Supports filtering by exact match, exclusion, and containment operators.
      - DealId — unresolved $ref
      - object — Filter deal_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` DealId — unresolved $ref
        - `not_eq` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `not_contain` DealId — unresolved $ref
    - `payment_status` union — Payment status of the invoice. Supports filtering by exact match, exclusion, and containment operators.
      - PaymentStatus — unresolved $ref
      - object — Filter payment_status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` PaymentStatus — unresolved $ref
        - `not_contain` PaymentStatus — unresolved $ref
        - `contains` PaymentStatus — unresolved $ref
        - `not_eq` PaymentStatus — unresolved $ref
    - `tags` union — Tags applied to this invoice. Supports filtering by exact match, exclusion, and containment operators.
      - Tags — unresolved $ref
      - object — Filter tags using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
        - `not_eq` Tags — unresolved $ref
        - `eq` Tags — unresolved $ref
    - `fuzzy_dates` union — Fuzzy date search across date fields. Supports filtering by exact match, exclusion, and containment operators.
      - FuzzyDates — unresolved $ref
      - object — Filter fuzzy_dates using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` FuzzyDates — unresolved $ref
        - `eq` FuzzyDates — unresolved $ref
    - `subscriber_id` union — Subscriber person ID. Supports filtering by exact match, exclusion, and containment operators.
      - SubscriberId — unresolved $ref
      - object — Filter subscriber_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` SubscriberId — unresolved $ref
        - `contains` SubscriberId — unresolved $ref
        - `eq` SubscriberId — unresolved $ref
        - `not_contain` SubscriberId — unresolved $ref
    - `amount_written_off` union — Amount written off as uncollectible (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter amount_written_off using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` AmountWrittenOff — unresolved $ref
        - `not_eq` AmountWrittenOff — unresolved $ref
        - `not_contain` AmountWrittenOff — unresolved $ref
        - `contains` AmountWrittenOff — unresolved $ref
      - AmountWrittenOff — unresolved $ref
    - `company_id` union — Client company ID. Supports filtering by exact match, exclusion, and containment operators.
      - CompanyId — unresolved $ref
      - object — Filter company_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
    - `invoice_aging` union — Invoice aging value in days since issue date. Supports filtering by exact match, exclusion, and containment operators.
      - InvoiceAging — unresolved $ref
      - object — Filter invoice_aging using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` InvoiceAging — unresolved $ref
        - `not_eq` InvoiceAging — unresolved $ref
        - `not_contain` InvoiceAging — unresolved $ref
        - `contains` InvoiceAging — unresolved $ref
    - `amount_unpaid` union — Outstanding balance (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter amount_unpaid using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` AmountUnpaid — unresolved $ref
        - `contains` AmountUnpaid — unresolved $ref
        - `not_eq` AmountUnpaid — unresolved $ref
        - `eq` AmountUnpaid — unresolved $ref
      - AmountUnpaid — unresolved $ref
    - `delivery_on` union — Date when goods or services were delivered. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter delivery_on using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` DeliveryOn — unresolved $ref
        - `not_eq` DeliveryOn — unresolved $ref
        - `contains` DeliveryOn — unresolved $ref
        - `eq` DeliveryOn — unresolved $ref
      - DeliveryOn — unresolved $ref
    - `status` union — General status filter. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter status using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` Status — unresolved $ref
        - `contains` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `eq` Status — unresolved $ref
      - Status — unresolved $ref
    - `invoicing_method` union — Invoicing method used to generate line items. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter invoicing_method using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` InvoicingMethod — unresolved $ref
        - `contains` InvoicingMethod — unresolved $ref
        - `not_contain` InvoicingMethod — unresolved $ref
        - `not_eq` InvoicingMethod — unresolved $ref
      - InvoicingMethod — unresolved $ref
    - `payment_terms_type` union
      - PaymentTermsType — unresolved $ref
      - object
        - `not_eq` PaymentTermsType — unresolved $ref
        - `not_contain` PaymentTermsType — unresolved $ref
        - `contains` PaymentTermsType — unresolved $ref
        - `eq` PaymentTermsType — unresolved $ref
    - `jump_query` union — Quick search term across key invoice fields. Supports filtering by exact match, exclusion, and containment operators.
      - JumpQuery — unresolved $ref
      - object — Filter jump_query using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` JumpQuery — unresolved $ref
        - `contains` JumpQuery — unresolved $ref
        - `not_eq` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
    - `paid_on` union — Date when the invoice was paid. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter paid_on using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` PaidOn — unresolved $ref
        - `not_contain` PaidOn — unresolved $ref
        - `not_eq` PaidOn — unresolved $ref
        - `eq` PaidOn — unresolved $ref
      - PaidOn — unresolved $ref
    - `parent_invoice_id` union — Parent invoice ID (for credit notes). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter parent_invoice_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` ParentInvoiceId — unresolved $ref
        - `not_eq` ParentInvoiceId — unresolved $ref
        - `not_contain` ParentInvoiceId — unresolved $ref
        - `contains` ParentInvoiceId — unresolved $ref
      - ParentInvoiceId — unresolved $ref
    - `invoice_state` union — Invoice lifecycle state (draft, finalized, sent, paid). Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter invoice_state using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` InvoiceState — unresolved $ref
        - `eq` InvoiceState — unresolved $ref
        - `not_eq` InvoiceState — unresolved $ref
        - `contains` InvoiceState — unresolved $ref
      - InvoiceState — unresolved $ref
    - `creator_id` union — Creator person ID. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter creator_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `not_eq` CreatorId — unresolved $ref
      - CreatorId — unresolved $ref
    - `pay_on` union — Due date for payment. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter pay_on using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` PayOn — unresolved $ref
        - `not_eq` PayOn — unresolved $ref
        - `eq` PayOn — unresolved $ref
        - `not_contain` PayOn — unresolved $ref
      - PayOn — unresolved $ref
    - `amount_tax` union — Total tax amount (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - AmountTax — unresolved $ref
      - object — Filter amount_tax using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` AmountTax — unresolved $ref
        - `eq` AmountTax — unresolved $ref
        - `not_eq` AmountTax — unresolved $ref
        - `not_contain` AmountTax — unresolved $ref
    - `invoiced_on` union — Date when the invoice was issued. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter invoiced_on using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` InvoicedOn — unresolved $ref
        - `eq` InvoicedOn — unresolved $ref
        - `not_contain` InvoicedOn — unresolved $ref
        - `contains` InvoicedOn — unresolved $ref
      - InvoicedOn — unresolved $ref
    - `id` union — Invoice ID. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `contains` Id — unresolved $ref
      - Id — unresolved $ref
    - `number` union — Invoice number. Supports filtering by exact match, exclusion, and containment operators.
      - Number — unresolved $ref
      - object — Filter number using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` Number — unresolved $ref
        - `not_contain` Number — unresolved $ref
        - `eq` Number — unresolved $ref
        - `contains` Number — unresolved $ref
    - `created_at` union — Invoice creation timestamp. Supports filtering by exact match, exclusion, and containment operators.
      - CreatedAt — unresolved $ref
      - object — Filter created_at using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_contain` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
    - `project_id` union — Project ID. Supports filtering by exact match, exclusion, and containment operators.
      - ProjectId — unresolved $ref
      - object — Filter project_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
    - `responsible_id` union — Responsible person ID. Supports filtering by exact match, exclusion, and containment operators.
      - ResponsibleId — unresolved $ref
      - object — Filter responsible_id using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `not_eq` ResponsibleId — unresolved $ref
        - `not_contain` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
        - `eq` ResponsibleId — unresolved $ref
    - `purchase_order_number` union — Client-provided purchase order number. Supports filtering by exact match, exclusion, and containment operators.
      - object — Filter purchase_order_number using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `eq` PurchaseOrderNumber — unresolved $ref
        - `not_contain` PurchaseOrderNumber — unresolved $ref
        - `not_eq` PurchaseOrderNumber — unresolved $ref
        - `contains` PurchaseOrderNumber — unresolved $ref
      - PurchaseOrderNumber — unresolved $ref
    - `amount_with_tax` union — Invoice total including tax (base currency). Supports filtering by exact match, exclusion, and containment operators.
      - AmountWithTax — unresolved $ref
      - object — Filter amount_with_tax using explicit operator object with eq, not_eq, contains, and not_contain operators.
        - `contains` AmountWithTax — unresolved $ref
        - `not_contain` AmountWithTax — unresolved $ref
        - `not_eq` AmountWithTax — unresolved $ref
        - `eq` AmountWithTax — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection invoice

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)