Fetch bill detail
GET/v1/entities/:entity_id/bills/:uuid
Retrieves one bill by uuid, in any state.
Requires the bills:read scope.
The uuid must be a UUID. /v1/entities/{entity_id}/bills/ with no uuid, or with a
value that is not a UUID, is not an inventory endpoint: an API key gets 401
{"error": "Invalid API key"} there. To find bills, list them for a receipt.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 504
The bill.
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 bill with that uuid for this entity.
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.