Overview
GET /quotes/{id} returns an issued quote: the frozen, numbered document sent to the client. It follows the same conventions as invoices - amounts in cents, business dates in YYYY-MM-DD, timestamps in Unix milliseconds, explicit null - plus quote-specific fields: lifecycle status, validity date, versioning and electronic signature.
Quote IDs are found in the quote_ids array of booking payloads, and in the quote_id field of payment and invoice webhooks. To be notified of quote lifecycle changes in real time (issued, sent, validated/signed, canceled), subscribe to the quote webhooks.
List quotes
limit 1-100 default 25, opaque cursor, response { "items": [...], "next_cursor": "..." }), newest first. Filters: created_from/created_to (Unix ms, issue date) and status (draft, ongoing, sent, validated, canceled - canceled includes expired quotes). Items use the full quote payload below.
Iterate on
next_cursor until it is null: a page may contain fewer than limit items even when more data remains. There is no service-date filter: to find quotes by event date, use GET /bookings?date_from=... and follow quote_ids.Get a quote
Line-to-event association. Each line carries an
event_id referencing the event it was sold for - the same IDs as events[].id in booking payloads, letting you group lines per day the way the quote PDF does. It is null for lines not tied to a specific event (accommodation, tourist tax): those attach to the booking as a whole via the top-level booking_id.Package composition. Lines are flattened (amounts live on the components), but each component carries a package block ({ id, name } of its parent package, null for standalone lines): group lines sharing the same package.id to reconstruct the parent/components structure shown on the PDF.Category and catalog link. tag is the catalog category of the line (Food, Drinks, Staff… the tag of GET /products), useful to build categorized documents from a quote. product_id points back to the catalog product when the line was created through POST /events/create with a product_id (or is a package component added in the BookingShake package editor); other lines added in the interface do not keep that link (null).Lifecycle
Several quote versions can coexist on a booking (shared
number root, -vN suffix): the accepted one is the version with status: "validated".
Errors
A uniform 404 is returned when the quote does not exist, belongs to another venue, is an invoice (useGET /invoices/{id}), or was deleted.