Invoice Taxes Query

Available query

InvoiceTaxes — Returns a paginated report of taxes applied on invoices

This query is primarily used for tax reporting and summaries across multiple invoices.

Example Query:

GraphQL

query GetInvoiceTaxes(
  $where: QueryInvoiceTaxesWhereWhereConditions,
  $orderBy: [QueryInvoiceTaxesOrderByOrderByClause!]
) {
  InvoiceTaxes(where: $where, orderBy: $orderBy) {
    paginatorInfo {
      total
    }
    data {
      tax_amount
      invoice { id label status }
      tax_rate { id label rate }
    }
  }
}

---

Available fields

Field	Type	Description
tax_amount	Float	Total amount of tax calculated for this specific rate on the invoice.
invoice	Invoice	Associated invoice document.
tax_rate	TaxRate	Tax rate definition.
tax_ratable_type	String	Type of the item the tax applies to.
taxable_amount	Float	Amount the tax rate applies to.
applied_amount	Float	Taxable amount the tax was applied to.
tax_amount_company_currency	Float	Tax amount converted to the company currency.
document_customer_label	String	Customer name on the document.
document_status	String	Status of the document.
document_dated_at	Date	Date of the document.
document_due_at	Date	Due date of the document.

---

Filters

The following fields can be used in the where parameter:

tax_rate_id, tax_ratable_id, invoice_status, invoice_customer_id, invoice_customer_tag_id, invoice_due_at, invoice_dated_at, invoice_season_id.

Example Filters:

Field	Example
invoice_status	{ "column": "INVOICE_STATUS", "operator": "EQ", "value": "paid" }
invoice_dated_at	{ "column": "INVOICE_DATED_AT", "operator": "GTE", "value": "2025-01-01" }
tax_rate_id	{ "column": "TAX_RATE_ID", "operator": "EQ", "value": 100005 }

---

Sorting

You can sort results using the orderBy parameter:

• tax_rate_id
• tax_amount