List Purchase Orders for a Provider Bill Supplier
GET/api/accounting/provider-bills/review/purchase-orders
The purchase orders a goods supplier's provider bill can become a purchase invoice on: the supplier's received, not-yet-invoiced purchase orders. The wizard loads these when a person matches a contact to a supplier, and for the per-bill purchase order picker.
purchase-orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Query:
supplier_id(required, integer) - the SKU.io supplier.connection_id(optional, integer).
Each row: id, number, total (the order's total), invoice_total (what a purchase invoice on it would total now: received and not yet invoiced, at the order's prices, with tax unless the prices include it), open_charges (the order's charges not billed yet: id, description, total), currency. At commit the purchase invoice takes the open charges the provider bill's total includes (the set that comes closest to it), then books the provider's total: any remaining difference goes on a "Difference from Xero" / "Difference from QuickBooks" line.
Returns 422 without a valid supplier_id.
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
- 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.
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.