Load Older Provider Bills
POST/api/accounting/provider-bills/review/backfill
Load bills from an older date range into SKU.io's local copy of the provider's bills, so List Provider Bills to Review can see them. Use it when the list returns coverage.incomplete: true. Reads from the provider only; Nothing is written to Xero or QuickBooks.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Runs in the background. The response carries tracked_job_log_id; poll GET /api/tracked-job-logs/{trackedJobLog} for progress and the result.
Optional fields (query or body):
from(Y-m-d) - start of the range. Defaults to 12 months ago.to(Y-m-d, on or afterfrom) - end of the range. Defaults to today.connection_id(integer).
Returns 422 when a date is invalid. 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.