Get a bill

Returns a purchase bill in the credential-bound company. tax_type and unit_price_basis are gross (VAT included) or net (VAT excluded). Each unit_price is before discount, in that basis, consistent with the stored line amount; extracted drafts may have stored a net price beside a gross amount. Resend the returned editable line fields to bill.update to preserve amounts. Lines include tax_rule_id, tax_rule_name and vat_amount in the bill currency, before bill-level input-VAT caps or entitlement adjustments; the VAT return and journals show claimable VAT. attachments contains id, name, mime_type and size; read a file with bill.attachment using the bill id and attachmentId, optionally query.include_content=true. payments is included only with view_bank_accounts, as on the bill payment endpoints. It contains active booked settlements, oldest first: booked_transaction_id, payment_account_transaction_id (null without a bank line), payment_date, amount and currency_id (settled on this bill, in the bill currency), bank_amount and bank_currency_id (in the bank currency), bank_amount_shared (true when one bank line in another currency paid several documents, so bank_amount is the whole line) and payment_account (id and name); reversed and deleted bookings are excluded, and personal account identities and bank figures are private. journal_entry_ids names all journals directly belonging to the bill, including its reversal history. These three detail collections are returned by this single-bill read, not the bill list. The ETag is the If-Match value for updates. Requires the bills:read OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*