---
title: "Changes to List billing invoices"
method: GET
path: "/invoices"
---

# Changes to List billing invoices

`GET /invoices`

> Every recorded change to this operation, newest first.
> 230 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 230 revisions.

- **2026-10-20** `e92a4ba2fbb0`: 9 breaking, 18 info
- **2026-10-12** `6a825174a24f`: 1 info

## Changes

- **2026-10-20** `e92a4ba2fbb0`: 9 breaking, 18 info
  - the response property `data/items/contract_id` became nullable for the status `200`
  - the response property `data/items/document_state` became nullable for the status `200`
  - the response property `data/items/period_end` became nullable for the status `200`
  - the response property `data/items/period_start` became nullable for the status `200`
  - the response property `data/items/contract_id` became optional for the status `200`
  - the response property `data/items/document_state` became optional for the status `200`
  - the response property `data/items/period_end` became optional for the status `200`
  - the response property `data/items/period_start` became optional for the status `200`
  - the `data/items/document_state` response's property type changed from `string` to no type for status `200`
  - api operation id `listNativeInvoices` removed and replaced with `listBillingInvoices`
  - 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`
  - added the new optional `query` request parameter `status`
  - added the optional property `data/items/external_id` to the response with the `200` status
  - added the optional property `data/items/subscription_external_id` to the response with the `200` status
  - added the optional property `data/items/url` to the response with the `200` status
  - added the optional property `params/past_due` to the response with the `200` status
  - added the optional property `params/provider_type` to the response with the `200` status
  - added the optional property `params/q` to the response with the `200` status
  - added the optional property `params/status` to the response with the `200` status
  - added `#/components/schemas/InvoiceDocumentState` to the `data/items/document_state` response property `allOf` list for the response status `200`
  - removed the `credited` enum value from the `data/items/document_state` response property for the response status `200`
  - removed the `draft` enum value from the `data/items/document_state` response property for the response status `200`
  - removed the `finalized` enum value from the `data/items/document_state` response property for the response status `200`
  - removed the `void` enum value from the `data/items/document_state` response property for the response status `200`
  - added the required property `data/items/provider_type` to the response with the `200` status
- **2026-10-12** `6a825174a24f`: 1 info
  - endpoint added

---

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