---
title: "Get invoice reports"
method: GET
path: "/api/v2/reports/invoice_reports"
tags: ["Reports"]
---

# Get invoice reports

`GET /api/v2/reports/invoice_reports`

Retrieve aggregated invoice report data grouped by configurable dimensions.

## Query parameters

- `sort` string[]
- `group` 'company' | 'created_at' | 'creator' | 'currency' | 'custom_fields' | 'delivery_on' | 'einvoice_status' | 'fiscalization_status' | 'invoice' | 'invoice_aging' | 'invoice_state' | 'invoice_status' | 'invoice_type' | 'invoiced_on' | 'issuer' | 'last_activity_at' | 'month' | 'organization' | 'overdue_status' | 'paid_on' | 'pay_on' | 'payment_status' | 'quarter' | 'sent_on' | 'sent_status' | 'subsidiary' | 'week' | 'year'
- `filter` union — Filter schema for `invoice_report` 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.
  - FilterInvoiceReport — Available filter parameters for querying invoice report records.
    - `payment_status` union — Filter invoice report results by payment status.
      - object — Filter operator object for payment status.
        - `not_contain` PaymentStatus — unresolved $ref
        - `eq` PaymentStatus — unresolved $ref
        - `contains` PaymentStatus — unresolved $ref
        - `not_eq` PaymentStatus — unresolved $ref
      - PaymentStatus — unresolved $ref
    - `number` union — Filter invoice report results by number.
      - object — Filter operator object for number.
        - `contains` Number — unresolved $ref
        - `eq` Number — unresolved $ref
        - `not_eq` Number — unresolved $ref
        - `not_contain` Number — unresolved $ref
      - Number — unresolved $ref
    - `deal_id` union — Filter invoice report results by deal id.
      - DealId — unresolved $ref
      - object — Filter operator object for deal id.
        - `not_contain` DealId — unresolved $ref
        - `eq` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `not_eq` DealId — unresolved $ref
    - `overdue_status` union — Filter invoice report results by overdue status.
      - object — Filter operator object for overdue status.
        - `not_eq` OverdueStatus — unresolved $ref
        - `contains` OverdueStatus — unresolved $ref
        - `eq` OverdueStatus — unresolved $ref
        - `not_contain` OverdueStatus — unresolved $ref
      - OverdueStatus — unresolved $ref
    - `fuzzy_people` union — Filter invoice report results by fuzzy people.
      - object — Filter operator object for fuzzy people.
        - `not_eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
        - `eq` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
      - FuzzyPeople — unresolved $ref
    - `custom_fields` union — Filter invoice report results by custom fields.
      - object — Filter operator object for custom fields.
        - `contains` CustomFields — unresolved $ref
        - `eq` CustomFields — unresolved $ref
        - `not_contain` CustomFields — unresolved $ref
        - `not_eq` CustomFields — unresolved $ref
      - CustomFields — unresolved $ref
    - `amount_credited` union — Filter by the credited amount on the invoice, excluding tax.
      - AmountCredited — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` AmountCredited — unresolved $ref
        - `eq` AmountCredited — unresolved $ref
        - `not_contain` AmountCredited — unresolved $ref
        - `contains` AmountCredited — unresolved $ref
    - `responsible_id` union — Filter invoice report results by responsible id.
      - object — Filter operator object for responsible id.
        - `not_eq` ResponsibleId — unresolved $ref
        - `not_contain` ResponsibleId — unresolved $ref
        - `eq` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
      - ResponsibleId — unresolved $ref
    - `purchase_order_number` union — Filter invoice report results by purchase order number.
      - object — Filter operator object for purchase order number.
        - `contains` PurchaseOrderNumber — unresolved $ref
        - `eq` PurchaseOrderNumber — unresolved $ref
        - `not_eq` PurchaseOrderNumber — unresolved $ref
        - `not_contain` PurchaseOrderNumber — unresolved $ref
      - PurchaseOrderNumber — unresolved $ref
    - `fiscalization_status` union — Filter by the fiscalization status of the invoice.
      - FiscalizationStatus — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` FiscalizationStatus — unresolved $ref
        - `not_eq` FiscalizationStatus — unresolved $ref
        - `contains` FiscalizationStatus — unresolved $ref
        - `not_contain` FiscalizationStatus — unresolved $ref
    - `automatically_created` union — Filter invoice report results by automatically created.
      - AutomaticallyCreated — unresolved $ref
      - object — Filter operator object for automatically created.
        - `not_contain` AutomaticallyCreated — unresolved $ref
        - `eq` AutomaticallyCreated — unresolved $ref
        - `not_eq` AutomaticallyCreated — unresolved $ref
        - `contains` AutomaticallyCreated — unresolved $ref
    - `invoiced_on` union — Filter invoice report results by invoiced on.
      - InvoicedOn — unresolved $ref
      - object — Filter operator object for invoiced on.
        - `contains` InvoicedOn — unresolved $ref
        - `not_contain` InvoicedOn — unresolved $ref
        - `not_eq` InvoicedOn — unresolved $ref
        - `eq` InvoicedOn — unresolved $ref
    - `parent_company_id` union — Filter by the parent company of the invoice's company.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` ParentCompanyId — unresolved $ref
        - `contains` ParentCompanyId — unresolved $ref
        - `eq` ParentCompanyId — unresolved $ref
        - `not_contain` ParentCompanyId — unresolved $ref
      - ParentCompanyId — unresolved $ref
    - `company_id` union — Filter invoice report results by company id.
      - object — Filter operator object for company id.
        - `not_eq` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
        - `contains` CompanyId — unresolved $ref
      - CompanyId — unresolved $ref
    - `created_at` union — Filter invoice report results by created at.
      - CreatedAt — unresolved $ref
      - object — Filter operator object for created at.
        - `not_eq` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
    - `currency_id` union — Filter invoice report results by currency id.
      - object — Filter operator object for currency id.
        - `contains` CurrencyId — unresolved $ref
        - `eq` CurrencyId — unresolved $ref
        - `not_eq` CurrencyId — unresolved $ref
        - `not_contain` CurrencyId — unresolved $ref
      - CurrencyId — unresolved $ref
    - `currency` union — Filter invoice report results by currency.
      - object — Filter operator object for currency.
        - `contains` Currency — unresolved $ref
        - `not_eq` Currency — unresolved $ref
        - `not_contain` Currency — unresolved $ref
        - `eq` Currency — unresolved $ref
      - Currency — unresolved $ref
    - `credited` union — Filter invoice report results by credited.
      - object — Filter operator object for credited.
        - `eq` Credited — unresolved $ref
        - `not_eq` Credited — unresolved $ref
        - `contains` Credited — unresolved $ref
        - `not_contain` Credited — unresolved $ref
      - Credited — unresolved $ref
    - `sent_status` union — Filter invoice report results by sent status.
      - SentStatus — unresolved $ref
      - object — Filter operator object for sent status.
        - `not_contain` SentStatus — unresolved $ref
        - `contains` SentStatus — unresolved $ref
        - `eq` SentStatus — unresolved $ref
        - `not_eq` SentStatus — unresolved $ref
    - `jump_query` union — Filter invoice report results by jump query.
      - object — Filter operator object for jump query.
        - `not_eq` JumpQuery — unresolved $ref
        - `contains` JumpQuery — unresolved $ref
        - `not_contain` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
      - JumpQuery — unresolved $ref
    - `sent_on` union — Filter invoice report results by sent on.
      - SentOn — unresolved $ref
      - object — Filter operator object for sent on.
        - `contains` SentOn — unresolved $ref
        - `not_contain` SentOn — unresolved $ref
        - `not_eq` SentOn — unresolved $ref
        - `eq` SentOn — unresolved $ref
    - `amount_paid` union — Filter by paid amount range.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` AmountPaid — unresolved $ref
        - `contains` AmountPaid — unresolved $ref
        - `not_eq` AmountPaid — unresolved $ref
        - `not_contain` AmountPaid — unresolved $ref
      - AmountPaid — unresolved $ref
    - `invoice_state` union — Filter invoice report results by invoice state.
      - InvoiceState — unresolved $ref
      - object — Filter operator object for invoice state.
        - `not_contain` InvoiceState — unresolved $ref
        - `contains` InvoiceState — unresolved $ref
        - `not_eq` InvoiceState — unresolved $ref
        - `eq` InvoiceState — unresolved $ref
    - `amount_credited_with_tax` union — Filter by the credited amount on the invoice, including tax.
      - AmountCreditedWithTax — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` AmountCreditedWithTax — unresolved $ref
        - `contains` AmountCreditedWithTax — unresolved $ref
        - `not_eq` AmountCreditedWithTax — unresolved $ref
        - `not_contain` AmountCreditedWithTax — unresolved $ref
    - `einvoice_status` union — Filter by the e-invoice delivery status.
      - EinvoiceStatus — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` EinvoiceStatus — unresolved $ref
        - `not_contain` EinvoiceStatus — unresolved $ref
        - `not_eq` EinvoiceStatus — unresolved $ref
        - `eq` EinvoiceStatus — unresolved $ref
    - `tax_rates` union — Filter invoice report results by tax rates.
      - TaxRates — unresolved $ref
      - object — Filter operator object for tax rates.
        - `not_contain` TaxRates — unresolved $ref
        - `eq` TaxRates — unresolved $ref
        - `contains` TaxRates — unresolved $ref
        - `not_eq` TaxRates — unresolved $ref
    - `status` union — Filter invoice report results by status.
      - Status — unresolved $ref
      - object — Filter operator object for status.
        - `not_eq` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `contains` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
    - `amount_written_off` union — Filter invoice report results by amount written off.
      - AmountWrittenOff — unresolved $ref
      - object — Filter operator object for amount written off.
        - `not_eq` AmountWrittenOff — unresolved $ref
        - `contains` AmountWrittenOff — unresolved $ref
        - `eq` AmountWrittenOff — unresolved $ref
        - `not_contain` AmountWrittenOff — unresolved $ref
    - `invoice_aging` union — Filter invoice report results by invoice aging.
      - object — Filter operator object for invoice aging.
        - `contains` InvoiceAging — unresolved $ref
        - `not_eq` InvoiceAging — unresolved $ref
        - `eq` InvoiceAging — unresolved $ref
        - `not_contain` InvoiceAging — unresolved $ref
      - InvoiceAging — unresolved $ref
    - `amount_with_tax` union — Filter invoice report results by amount with tax.
      - object — Filter operator object for amount with tax.
        - `eq` AmountWithTax — unresolved $ref
        - `not_eq` AmountWithTax — unresolved $ref
        - `not_contain` AmountWithTax — unresolved $ref
        - `contains` AmountWithTax — unresolved $ref
      - AmountWithTax — unresolved $ref
    - `project_id` union — Filter invoice report results by project id.
      - ProjectId — unresolved $ref
      - object — Filter operator object for project id.
        - `not_eq` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `delivery_on` union — Filter invoice report results by delivery on.
      - object — Filter operator object for delivery on.
        - `eq` DeliveryOn — unresolved $ref
        - `contains` DeliveryOn — unresolved $ref
        - `not_eq` DeliveryOn — unresolved $ref
        - `not_contain` DeliveryOn — unresolved $ref
      - DeliveryOn — unresolved $ref
    - `amount_tax` union — Filter by tax amount range.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` AmountTax — unresolved $ref
        - `contains` AmountTax — unresolved $ref
        - `eq` AmountTax — unresolved $ref
        - `not_contain` AmountTax — unresolved $ref
      - AmountTax — unresolved $ref
    - `parent_invoice_id` union — Filter invoice report results by parent invoice id.
      - ParentInvoiceId — unresolved $ref
      - object — Filter operator object for parent invoice id.
        - `not_contain` ParentInvoiceId — unresolved $ref
        - `eq` ParentInvoiceId — unresolved $ref
        - `contains` ParentInvoiceId — unresolved $ref
        - `not_eq` ParentInvoiceId — unresolved $ref
    - `query` union — Filter invoice report results by query.
      - object — Filter operator object for query.
        - `not_contain` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
      - Query — unresolved $ref
    - `issuer_id` union — Filter invoice report results by issuer id.
      - IssuerId — unresolved $ref
      - object — Filter operator object for issuer id.
        - `contains` IssuerId — unresolved $ref
        - `eq` IssuerId — unresolved $ref
        - `not_contain` IssuerId — unresolved $ref
        - `not_eq` IssuerId — unresolved $ref
    - `pay_on` union — Filter invoice report results by pay on.
      - PayOn — unresolved $ref
      - object — Filter operator object for pay on.
        - `not_eq` PayOn — unresolved $ref
        - `not_contain` PayOn — unresolved $ref
        - `contains` PayOn — unresolved $ref
        - `eq` PayOn — unresolved $ref
    - `invoice_type` union — Filter invoice report results by invoice type.
      - object — Filter operator object for invoice type.
        - `not_eq` InvoiceType — unresolved $ref
        - `contains` InvoiceType — unresolved $ref
        - `eq` InvoiceType — unresolved $ref
        - `not_contain` InvoiceType — unresolved $ref
      - InvoiceType — unresolved $ref
    - `full_query` union — Filter invoice report results by full query.
      - FullQuery — unresolved $ref
      - object — Filter operator object for full query.
        - `not_contain` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
        - `contains` FullQuery — unresolved $ref
        - `not_eq` FullQuery — unresolved $ref
    - `invoicing_method` union — Filter invoice report results by invoicing method.
      - InvoicingMethod — unresolved $ref
      - object — Filter operator object for invoicing method.
        - `not_eq` InvoicingMethod — unresolved $ref
        - `contains` InvoicingMethod — unresolved $ref
        - `eq` InvoicingMethod — unresolved $ref
        - `not_contain` InvoicingMethod — unresolved $ref
    - `export_status` union — Filter invoice report results by export status.
      - object — Filter operator object for export status.
        - `not_eq` ExportStatus — unresolved $ref
        - `not_contain` ExportStatus — unresolved $ref
        - `eq` ExportStatus — unresolved $ref
        - `contains` ExportStatus — unresolved $ref
      - ExportStatus — unresolved $ref
    - `formulas` union — Filter invoice report results by formulas.
      - Formulas — unresolved $ref
      - object — Filter operator object for formulas.
        - `not_eq` Formulas — unresolved $ref
        - `not_contain` Formulas — unresolved $ref
        - `eq` Formulas — unresolved $ref
        - `contains` Formulas — unresolved $ref
    - `amount_unpaid` union — Filter by unpaid amount range.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` AmountUnpaid — unresolved $ref
        - `contains` AmountUnpaid — unresolved $ref
        - `not_contain` AmountUnpaid — unresolved $ref
        - `not_eq` AmountUnpaid — unresolved $ref
      - AmountUnpaid — unresolved $ref
    - `paid_on` union — Filter invoice report results by paid on.
      - object — Filter operator object for paid on.
        - `not_eq` PaidOn — unresolved $ref
        - `not_contain` PaidOn — unresolved $ref
        - `contains` PaidOn — unresolved $ref
        - `eq` PaidOn — unresolved $ref
      - PaidOn — unresolved $ref
    - `tags` union — Filter by tag.
      - Tags — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Tags — unresolved $ref
        - `contains` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
        - `eq` Tags — unresolved $ref
    - `invoice_status` union — Filter invoice report results by invoice status.
      - object — Filter operator object for invoice status.
        - `eq` InvoiceStatus — unresolved $ref
        - `contains` InvoiceStatus — unresolved $ref
        - `not_eq` InvoiceStatus — unresolved $ref
        - `not_contain` InvoiceStatus — unresolved $ref
      - InvoiceStatus — unresolved $ref
    - `amount` union — Filter by the total invoice amount excluding tax. Expressed in the organization's base currency.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Amount — unresolved $ref
        - `not_contain` Amount — unresolved $ref
        - `eq` Amount — unresolved $ref
        - `contains` Amount — unresolved $ref
      - Amount — unresolved $ref
    - `last_activity_at` union — Filter by last activity date range (`last_activity_at`).
      - LastActivityAt — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `eq` LastActivityAt — unresolved $ref
        - `not_eq` LastActivityAt — unresolved $ref
        - `not_contain` LastActivityAt — unresolved $ref
        - `contains` LastActivityAt — unresolved $ref
    - `subscriber_id` union — Filter invoice report results by subscriber id.
      - SubscriberId — unresolved $ref
      - object — Filter operator object for subscriber id.
        - `contains` SubscriberId — unresolved $ref
        - `not_contain` SubscriberId — unresolved $ref
        - `not_eq` SubscriberId — unresolved $ref
        - `eq` SubscriberId — unresolved $ref
    - `payment_terms` union — Filter invoice report results by payment terms.
      - PaymentTerms — unresolved $ref
      - object — Filter operator object for payment terms.
        - `contains` PaymentTerms — unresolved $ref
        - `not_eq` PaymentTerms — unresolved $ref
        - `eq` PaymentTerms — unresolved $ref
        - `not_contain` PaymentTerms — unresolved $ref
    - `creator_id` union — Filter invoice report results by creator id.
      - CreatorId — unresolved $ref
      - object — Filter operator object for creator id.
        - `not_eq` CreatorId — unresolved $ref
        - `not_contain` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
    - `id` union — Filter invoice report results by id.
      - object — Filter operator object for id.
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
      - Id — unresolved $ref
    - `subsidiary_id` union — Filter invoice report results by subsidiary id.
      - object — Filter operator object for subsidiary id.
        - `contains` SubsidiaryId — unresolved $ref
        - `eq` SubsidiaryId — unresolved $ref
        - `not_eq` SubsidiaryId — unresolved $ref
        - `not_contain` SubsidiaryId — unresolved $ref
      - SubsidiaryId — unresolved $ref
    - `fuzzy_dates` union — Filter invoice report results by fuzzy dates.
      - object — Filter operator object for fuzzy dates.
        - `not_contain` FuzzyDates — unresolved $ref
        - `contains` FuzzyDates — unresolved $ref
        - `not_eq` FuzzyDates — unresolved $ref
        - `eq` FuzzyDates — unresolved $ref
      - FuzzyDates — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection invoice report

---

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