List Provider Bills to Review
GET/api/accounting/provider-bills/review
Find the bills already in Xero or QuickBooks that are not in SKU.io yet, over a date range. Reads SKU.io's local copy of the provider's bills; Nothing is written to Xero or QuickBooks.
purchase-orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Bills SKU.io already has (same supplier and normalized number) are counted in counts.already_in_sku and left out. The rest are sorted into:
groups- open bills grouped by provider contact, largest total first. Each group:key,contact_id,contact_name,supplier,supplier_source(mappedorname),bill_count,total,currency,with_number,with_detail,with_file,suggestion,purchase_orders(the supplier's received, not-yet-invoiced purchase orders:id,number,total,invoice_total- what a purchase invoice on it would total now,open_charges- the order's charges not billed yet (id,description,total),currency),totals_by_currency(the group's total per currency:currency,total) andbills.possible_matches- bills that look like a SKU.io document with the same supplier, total and date. A pair marked Not a Duplicate is no longer matched.ignored- bills ignored by a decision or by an always-ignore contact.
Other fields: connection_id (the connection scanned; without connection_id the tenant's accounting connection, else the first one), connections (every Xero / QuickBooks connection: id, provider, provider_label, name - the wizard shows a selector when there is more than one), header_changes (bills already brought in whose supplier or currency the provider changed since: remote_id, review_id, number, contact_name, record (type, id), changes (supplier / currency / number, each from, to) - SKU.io never remaps these; resolve with Keep Provider Bill Header Change), provider, provider_label, range (from, to), coverage (incomplete is true when the local copy does not reach back to from - call Load Older Provider Bills first; cached_from), attachments_authorized (whether the connection may download the provider's files), ocr_enabled (whether uploaded invoices are read), and counts (unknown, unknown_total, open, open_total, classified_bill, classified_bill_total, classified_purchase_invoice, classified_purchase_invoice_total, failed, ignored, ignored_total, possible_matches, already_in_sku, and totals_by_currency: for unknown, open, classified_bill, classified_purchase_invoice and ignored, a list of currency (null = the home currency) and total). Provider amounts are never converted, so the *_total sums only mean something when every bill is in one currency; show totals_by_currency instead.
Bill row fields: remote_id, contact_id, contact_name, number, date, due_date, total, amount_due, currency, status (the provider's status), has_number, has_detail (has line detail), file (provider fetched from the provider, uploaded, in_provider the provider has a file not yet fetched, none, unknown), line_count, lines_summary, supplier (the matched SKU.io supplier: id, name, type), suggestion (classification, purchase_order, reason), possible_match (an existing SKU.io document with the same supplier, total and date), and review (the saved decision, or null).
Returns 404 when the tenant has no Xero or QuickBooks connection.
Authentication: Requires Bearer token. Scope: purchase-orders (read/write). The user must hold the Review provider bills permission (bills.review_provider).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.