---
title: "Get invoices"
method: GET
path: "/public/v1/invoices"
tags: ["Invoice"]
---

# Get invoices

`GET /public/v1/invoices`

List the company's invoices, newest first (sorted by invoice date, descending), with the given filters applied. All filters combine with AND; each returned invoice matches every filter you pass. This is a read-only operation with no side effects.

Results are paginated. The response carries a `next_page` URL only while more pages remain; follow it to walk the full result set. Page size is fixed at 500 invoices.

This endpoint returns eventually consistent data: a just-created or just-updated invoice may take up to about 1 second to appear or reflect its latest values here.

Required permission: `invoices_permissions_view`. Results are further narrowed to only the invoices the authenticated user is allowed to see under their team restrictions, so two API keys on the same company can see different subsets.

## Query parameters

- `ids` string[]
- `due_datetime` string
- `inserted_datetime` string
- `invoice_datetime` string
- `invoice_number` string
- `statuses` string[]
- `order_ids` string[]
- `order_numbers` string[]
- `order_statuses` string[]
- `company_ids` string[]
- `company_group_ids` string[]
- `owner_ids` string[]
- `invoice_numbers` string[]
- `is_voided` boolean
- `total` string
- `remaining_amount` string
- `page` string
- `updated_datetime` string
- `voided_datetime` string
- `batch_ids` string[]
- `package_ids` string[]
- `package_compliance_labels` string[]
- `package_batch_numbers` string[]
- `batch_batch_numbers` string[]
- `product_ids` string[]
- `product_category_ids` string[]
- `product_subcategory_ids` string[]
- `product_group_ids` string[]
- `product_brand_ids` string[]
- `product_vendor_ids` string[]
- `product_strain_ids` string[]
- `product_tag_ids` string[]
- `product_skus` string[]
- `custom_data` object

## Response `200`

A list of invoices

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

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