Creates a new quote in draft status. Totals are automatically calculated from the provided line items.
Quote numbers are auto-generated using the format {PREFIX}-{YEAR}-{COUNTER}-{VERSION} where the counter is a 5-digit zero-padded number and the version starts at 1 (e.g., QUO-2025-00001-1).
If issue_date is not provided, today’s date is used. If valid_until is not provided, it defaults to 30 days after the issue date.
API key authentication. Generate keys from the Corebill dashboard under the Developers section.
Example: Authorization: Bearer sk_live_abc123def456
The company ID to scope the request to
Customer ID to associate with this quote
"cus_a1b2c3d4e5f6"
Quote issue date (defaults to today)
"2025-04-15"
Quote expiration date (defaults to 30 days from issue_date)
"2025-05-15"
Currency code (ISO 4217). Defaults to company currency or USD
"USD"
Quote notes visible to the customer
"This quote is valid for 30 days"
Payment terms description
"50% upfront, 50% on delivery"
Tax rate as a percentage (e.g., 16 for 16%)
0
Tax identifier or label
"VAT"
Type of discount to apply
percentage, fixed "fixed"
Discount value (percentage or fixed amount)
500
Line items for the quote
Quote created successfully
Full quote object including items and public_token (returned by GET /quotes/{id} and POST /quotes)