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

# Changes to List invoices

`GET /api/v1/invoices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 54 revisions.

- **2026-08-27** (v1) `03f9d8ae5c5e`: 2 info
- **2026-08-21** (v1) `174308f2d7c7`: 2 warning
- **2026-03-30** (v1) `5cb340234766`: 1 info
- **2026-03-27** (v1) `de35c02bb0d2`: 4 breaking, 28 warning, 31 info
- **2026-01-20** (v1) `665f680338b5`: 2 info
- **2025-12-17** (v1) `2244ec0dabe3`: 1 breaking, 4 warning, 4 info
- **2025-10-13** (v1) `76f228b9e0eb`: 1 info
- **2025-07-09** (v1) `dece17f86f99`: 1 breaking

## Changes

- **2026-08-27** (v1) `03f9d8ae5c5e`: 2 info
  - added the optional property `data/items/tax_breakdown/items/exemption_reason` to the response with the `200` status
  - added the optional property `data/items/tax_breakdown/items/tax_reference` to the response with the `200` status
- **2026-08-21** (v1) `174308f2d7c7`: 2 warning
  - added the new `PROCESSING` enum value to the `data/items/payment_status` response property for the response status `200`
  - added the new `REFUNDED` enum value to the `data/items/transactions/items/status` response property for the response status `200`
- **2026-03-30** (v1) `5cb340234766`: 1 info
  - added the new optional `query` request parameter `order_by`
- **2026-03-27** (v1) `de35c02bb0d2`: 4 breaking, 28 warning, 31 info
  - removed the enum value `Draft` from the property `items/` of the `query` request parameter `statuses`
  - removed the enum value `Finalized` from the property `items/` of the `query` request parameter `statuses`
  - removed the enum value `Uncollectible` from the property `items/` of the `query` request parameter `statuses`
  - removed the enum value `Void` from the property `items/` of the `query` request parameter `statuses`
  - added the new `ADJUSTMENT` enum value to the `data/items/invoice_type` response property for the response status `200`
  - added the new `BANK_TRANSFER` enum value to the `data/items/transactions/items/payment_method_info/oneOf[#/components/schemas/PaymentMethodInfo]/payment_method_type` response property for the response status `200`
  - added the new `CANCELLED` enum value to the `data/items/transactions/items/status` response property for the response status `200`
  - added the new `CARD` enum value to the `data/items/transactions/items/payment_method_info/oneOf[#/components/schemas/PaymentMethodInfo]/payment_method_type` response property for the response status `200`
  - added the new `DRAFT` enum value to the `data/items/status` response property for the response status `200`
  - added the new `ERRORED` enum value to the `data/items/payment_status` response property for the response status `200`
  - added the new `FAILED` enum value to the `data/items/transactions/items/status` response property for the response status `200`
  - added the new `FINALIZED` enum value to the `data/items/status` response property for the response status `200`
  - added the new `NOT_REGISTERED` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new `ONE_OFF` enum value to the `data/items/invoice_type` response property for the response status `200`
  - added the new `OTHER` enum value to the `data/items/transactions/items/payment_method_info/oneOf[#/components/schemas/PaymentMethodInfo]/payment_method_type` response property for the response status `200`
  - added the new `PAID` enum value to the `data/items/payment_status` response property for the response status `200`
  - added the new `PARTIALLY_PAID` enum value to the `data/items/payment_status` response property for the response status `200`
  - added the new `PAYMENT` enum value to the `data/items/transactions/items/payment_type` response property for the response status `200`
  - added the new `PENDING` enum value to the `data/items/transactions/items/status` response property for the response status `200`
  - added the new `READY` enum value to the `data/items/transactions/items/status` response property for the response status `200`
  - added the new `RECURRING` enum value to the `data/items/invoice_type` response property for the response status `200`
  - added the new `REFUND` enum value to the `data/items/transactions/items/payment_type` response property for the response status `200`
  - added the new `REVERSE_CHARGE` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new `SETTLED` enum value to the `data/items/transactions/items/status` response property for the response status `200`
  - added the new `TAX_EXEMPT` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500`
  - added the new `UNCOLLECTIBLE` enum value to the `data/items/status` response property for the response status `200`
  - added the new `UNPAID` enum value to the `data/items/payment_status` response property for the response status `200`
  - added the new `USAGE_THRESHOLD` enum value to the `data/items/invoice_type` response property for the response status `200`
  - added the new `VOID` enum value to the `data/items/status` response property for the response status `200`
  - added the new `WALLET` enum value to the `data/items/transactions/items/payment_method_info/oneOf[#/components/schemas/PaymentMethodInfo]/payment_method_type` response property for the response status `200`
  - added the enum value `DRAFT` to the property `items/` of the `query` request parameter `statuses`
  - added the enum value `FINALIZED` to the property `items/` of the `query` request parameter `statuses`
  - added the enum value `UNCOLLECTIBLE` to the property `items/` of the `query` request parameter `statuses`
  - added the enum value `VOID` to the property `items/` of the `query` request parameter `statuses`
  - added the non-success response with the status `429`
  - removed the `Adjustment` enum value from the `data/items/invoice_type` response property for the response status `200`
  - removed the `BankTransfer` enum value from the `data/items/transactions/items/payment_method_info/oneOf[#/components/schemas/PaymentMethodInfo]/payment_method_type` response property for the response status `200`
  - removed the `Cancelled` enum value from the `data/items/transactions/items/status` response property for the response status `200`
  - …23 more
- **2026-01-20** (v1) `665f680338b5`: 2 info
  - api tag `Invoices` added
  - api tag `invoice` removed
- **2025-12-17** (v1) `2244ec0dabe3`: 1 breaking, 4 warning, 4 info
  - the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response's property type changed from no type to `string` for status `200`
  - deleted the `query` request parameter `status`
  - added the new `NotRegistered` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new `ReverseCharge` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new `TaxExempt` enum value to the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property for the response status `200`
  - added the new optional `query` request parameter `statuses`
  - the `query` request parameter `customer_id` became optional
  - for the `query` request parameter `customer_id`, the format was generalized from `MeteroidId` to no format
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `data/items/tax_breakdown/items/exemption_type/oneOf[#/components/schemas/TaxExemptionType]/` response property `oneOf` list for the response status `200`
- **2025-10-13** (v1) `76f228b9e0eb`: 1 info
  - endpoint added
- **2025-07-09** (v1) `dece17f86f99`: 1 breaking
  - api path removed without deprecation

---

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