---
title: "Count billing invoices"
method: GET
path: "/invoices/count"
tags: ["billing"]
---

# Count billing invoices

`GET /invoices/count`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/invoices/count`
- Auth: API key in header `X-Schematic-Api-Key`

## Query parameters

- `company_id` string
- `contract_id` string
- `document_state` 'credited' | 'draft' | 'finalized' | 'void'
- `past_due` boolean: Only open invoices with an amount left to pay whose due date has passed.
- `provider_type` 'metronome' | 'orb' | 'schematic' | 'stripe'
- `q` string: Search by invoice number, provider invoice ID or company name.
- `status` 'draft' | 'open' | 'paid' | 'uncollectible' | 'void'
- `limit` integer: Page limit (default 100)
- `offset` integer: Page offset (default 0)

## Response `200`

OK

- object
  - `data` CountResponse, required
    - `count` integer: The number of resources
  - `params` object, required: Input parameters
    - `company_id` string
    - `contract_id` string
    - `document_state` 'credited' | 'draft' | 'finalized' | 'void'
    - `limit` integer: Page limit (default 100)
    - `offset` integer: Page offset (default 0)
    - `past_due` boolean: Only open invoices with an amount left to pay whose due date has passed.
    - `provider_type` 'metronome' | 'orb' | 'schematic' | 'stripe'
    - `q` string: Search by invoice number, provider invoice ID or company name.
    - `status` 'draft' | 'open' | 'paid' | 'uncollectible' | 'void'

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Server error

## Changes

> 230 revisions in range; 1 not diffed.

- **2026-10-20** `e92a4ba2fbb0`: 9 info
  - api operation id `countNativeInvoices` removed and replaced with `countBillingInvoices`
  - added the new optional `query` request parameter `past_due`
  - added the new optional `query` request parameter `provider_type`
  - added the new optional `query` request parameter `q`
  - …5 more
- **2026-10-12** `6a825174a24f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/invoices/count/get.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/schematichq/apis/schematic-api/revisions/64cb7e17c236?raw)