Retrieve paginated list of invoices

Page number for pagination

Number of items per page

Filter invoices from this date. Accepted formats: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. All times are interpreted as UTC. When using expand=items, either date_from or last_modified_date_from is required.

UTC filter. Accepts ISO 8601 with optional Z/offset, or YYYY-MM-DD[ HH:MM:SS] (assumed UTC). Takes precedence over the non-_utc variant.

Filter invoices to this date. Accepted formats: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. All times are interpreted as UTC. When using expand=items and omitted, defaults to the current UTC datetime.

UTC filter. Accepts ISO 8601 with optional Z/offset, or YYYY-MM-DD[ HH:MM:SS] (assumed UTC). Takes precedence over the non-_utc variant.

Filter by one or more invoice statuses. Pass a comma-separated list to return invoices matching any listed status. Supported values: processing, needs-attention, pending-approval, ready-for-export, exported, inactive. When passing more than one status, the date range must be within 30 days and the search parameter cannot be used at the same time. If you pass no date filter at all, the last 30 days are used (date_from defaults to 30 days ago and date_to to now); if you do pass dates, your values are used as given and the 30-day limit still applies. Values approved, incomplete, and archived are legacy: they are accepted only as a single value and filter on the raw invoice state rather than the statuses above.

Filter by a comma-separated list of location IDs

Filter by payment status

Filter by specific vendor ID. With X-API-Version: 1.1.0 this is the accounting vendor id (matches the id from GET /vendors); for 1.0.0/unversioned it is the operational vendor id.

Filter by ERP vendor name (case-insensitive partial match).

Comma-separated list of fields to expand. Options: items. When used, returns full line item details along with catalog entry details. Requires date_from or last_modified_date_from (within a 30-day window); date_to and last_modified_date_to are optional and default to the current datetime if omitted.

Filter by a comma-separated list of invoice IDs

Search across multiple invoice fields

Filter by custom field values. Pass a JSON object where each key is a custom field name and each value is the exact value to match. Multiple keys are ANDed together.

Filter invoices last modified on or after this date. Accepted formats: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. All times are interpreted as UTC. When using expand=items, either last_modified_date_from or date_from is required.

UTC filter. Accepts ISO 8601 with optional Z/offset, or YYYY-MM-DD[ HH:MM:SS] (assumed UTC). Takes precedence over the non-_utc variant.

Filter invoices last modified on or before this date. Accepted formats: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. All times are interpreted as UTC. When using expand=items and omitted, defaults to the current UTC datetime.

UTC filter. Accepts ISO 8601 with optional Z/offset, or YYYY-MM-DD[ HH:MM:SS] (assumed UTC). Takes precedence over the non-_utc variant.

Filter invoices by the ID of the user who last modified them

OAuth2 authentication flows. Auth server URLs will vary by environment

API key for authentication

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.