List bills for a receipt
GET/v1/entities/:entity_id/receipts/:uuid/bills
Returns the bills created from one receipt, in any state. A bill can cover several receipts,
so the same bill can appear under more than one receipt. A uuid that is not one of your
committed receipts returns 404, the same as fetching that receipt. A committed receipt
with no bills returns an empty list. There is no endpoint that lists every bill.
Requires the bills:read scope.
The response is a plain JSON object. The root key is bills; pagination lives in meta
(page, per_page, total).
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 504
A page of bills.
The Authorization header is missing, is not HTTP Basic, or does not carry a valid API key. Create and manage keys under Settings → API keys in the Bookkeep section of the Bookkeep app.
The key does not hold bills:read, or the key's store is not linked to {entity_id}.
No committed receipt with that uuid for the key's store. A receipt that exists but is not committed returns 404 too.
Rate limit reached. The inventory endpoints share one limit of 60 requests per minute per source IP address, counted across Purchase Orders, Suppliers, Receipts and Bills. The count resets at the start of each minute. No Retry-After header is sent. The body is JSON only when the request sends Accept: application/json; otherwise it is an HTML page.
The service did not respond in time. This is a read, so it is safe to retry after a short wait.