A quote is an estimate of the invoice with the charges likely to occur when customers buy an item. A quote can be converted to a regular invoice once the customer accepts it.

Sample quote [ JSON ]

{ "amount_due": 500, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFByrXr", "date": 1517507449, "id": "7", "line_item_discounts": [], "line_item_taxes": [], "line_items": [{ "amount": 500, "date_from": 1517507449, "date_to": 1517507449, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuFBzxXy", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507449000, "status": "open", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517507449, "valid_till": 1517593849 }

API Index URL GET

https://{site}.chargebee.com/api/v2/quotes
id
The quote number. Acts as a identifier for quote and typically generated sequentially.
string, max chars=50
name
The quote name will be used as the pdf name of the quote.
optional, string, max chars=100
po_number
Purchase Order Number.
optional, string, max chars=100
customer_id
The identifier of the customer this quote belongs to.
string, max chars=50
subscription_id
The identifier of the subscription this quote belongs to.
optional, string, max chars=50
invoice_id
The identifier of the invoice generated while converting this quote.
optional, string, max chars=50
status
Current status of this quote.
enumerated string
Possible values are
openOpen.acceptedAccepted.declinedDeclined.invoicedInvoiced.closedClosed.
operation_type
Operation Type.
enumerated string
Possible values are
create_subscription_for_customercreate_subscription_for_customer.change_subscriptionchange_subscription.onetime_invoiceonetime_invoice.
vat_number
VAT/ Tax registration number of the customer. Learn more.
optional, string, max chars=20
price_type
The price type of the quote.
enumerated string, default=tax_exclusive
Possible values are
tax_exclusiveAll amounts in the document are exclusive of tax.tax_inclusiveAll amounts in the document are inclusive of tax.
valid_till
Quote will be valid till this date. After this date quote will be marked as closed.
timestamp(UTC) in seconds
date
Creation date of the quote. Typically this is the date on which quote is generated.
timestamp(UTC) in seconds
sub_total
Sub-total in cents.
in cents, min=0
total
Total in cents.
optional, in cents, default=0, min=0
credits_applied
Credits applied to this quote in cents.
optional, in cents, default=0, min=0
amount_paid
Existing outstanding payments if any, applied to this quote in cents.
optional, in cents, default=0, min=0
amount_due
Amount due in cents.
optional, in cents, default=0, min=0
resource_version
Version number of this resource. Each update of this resource results in incremental change of this number. This attribute will be present only if the resource has been updated after 2016-09-28.
optional, long
updated_at
Timestamp indicating when this quote was last updated.
optional, timestamp(UTC) in seconds
currency_code
The currency code (ISO 4217 format) of the quote.
string, max chars=3
notes
List of notes associated with this quotes.
optional, jsonarray
line_items
Show attributes[+]
The list of items in this quote.
optional, list of line_item
Line item attributes
id
Uniquely identifies a line_item.
optional, string, max chars=40
subscription_id
A unique identifier for the subscription this lineitem belongs to.
optional, string, max chars=3
date_from
Start date of this lineitem.
timestamp(UTC) in seconds
date_to
End date of this lineitem.
timestamp(UTC) in seconds
unit_amount
Unit amount of the lineitem.
in cents
quantity
Quantity of the recurring item which is represented by this lineitem.
optional, integer, default=1
amount
Total amount of this lineitem. Typically equals to unit amount x quantity.
optional, in cents
pricing_model
Charges a single price for the plan/addon.
optional, enumerated string
Possible values are
flat_feeCharge a single price on recurring basis.per_unitCharge the price for each unit of the plan for the subscription on recurring basis.tieredCharges a different per unit price for the quantity purchased from every tier.volumeCharges the per unit price for the total quantity purchased based on the tier under which it falls.stairstepCharges a price for a range.
is_taxed
Specifies whether this line item is taxed or not.
boolean, default=false
tax_amount
The tax amount charged for this item.
optional, in cents, default=0, min=0
tax_rate
Rate of tax used to calculate tax for this lineitem.
optional, double, min=0.0, max=100.0
discount_amount
Total discounts for this line.
optional, in cents, min=0
item_level_discount_amount
'Item' level discounts for this line.
optional, in cents, min=0
description
Detailed description about this lineitem.
string, max chars=250
entity_type
Specifies the modelled entity (plan / addon etc) this lineitem is based on.
enumerated string
Possible values are
plan_setupIndicates that this lineitem is based on 'Plan Setup' charge. The 'entity_id' attribute specifies the plan id.planIndicates that this lineitem is based on 'Plan' entity. The 'entity_id' attribute specifies the plan id.addonIndicates that this lineitem is based on 'Addon' entity. The 'entity_id' attribute specifies the addon id.adhocIndicates that this lineitem is not modelled. i.e created adhoc. So the 'entity_id' attribute will be null in this case.
tax_exempt_reason
The reason or category due to which the line item price/amount is excluded from taxable amount.
optional, enumerated string
Possible values are
tax_not_configuredIf tax is not enabled for the site.region_non_taxableIf the product sold is not taxable in this region, but it is taxable in other regions, hence this region is not part of the Taxable jurisdiction.exportIf the Merchant is not registered for Tax in this region, taxes will not be applied.customer_exemptIf the Customer is marked as Tax exempt.product_exemptIf the Plan or Addon is marked as Tax exempt.zero_ratedIf the rate of tax is 0% and no Sales/ GST tax is collectable for that line item.reverse_chargeIf the Customer is identified as B2B customer (when VAT Number is entered), applicable for EU only.high_value_physical_goodsIf physical goods are sold from outside Australia to customers in Australia, and the price of all the physical good line items is greater than AUD 1000, then tax will not be applied.
entity_id
The identifier of the modelled entity this lineitem is based on. Will be null for 'adhoc' entity type.
optional, string, max chars=100
customer_id
A unique identifier for the customer this lineitem belongs to.
optional, string, max chars=100
discounts
Show attributes[+]
The list of discounts applied to this quote.
optional, list of discount
Discount attributes
amount
Discount amount.
in cents, min=0
description
Detailed description of this discount line item.
optional, string, max chars=250
entity_type
Type of this Discount lineitem.
enumerated string
Possible values are
item_level_couponRepresents the 'Item' level coupons applied to this invoice. Further the 'entity_id' attribute specifies the coupon id this discount is based on.document_level_couponRepresents the 'Document' level coupons applied to this document. Further the 'entity_id' attribute specifies the coupon id this discount is based on.promotional_creditsRepresents the Promotional Credits item in invoice. The 'entity_id' attribute will be null in this case.prorated_creditsRepresents the credit adjustment items in invoice. The 'entity_id' attribute will be null in this case.
entity_id
The identifier of the modelled entity this lineitem is bases on. Will be null for 'Prorated Credits' & 'Promotional Credits'.
optional, string, max chars=100
line_item_discounts
Show attributes[+]
The list of discount(s) applied for each line item of this quote.
optional, list of line_item_discount
Line item discount attributes
line_item_id
The unique reference id of the line item for which the discount is applicable.
string, max chars=50
discount_type
Type of this discount line item.
enumerated string
Possible values are
item_level_couponRepresents the 'Item' level coupons applied to this invoice. Further the 'coupon_id' attribute specifies the coupon id this discount is based on.document_level_couponRepresents the 'Document' level coupons applied to this document. Further the 'coupon_id' attribute specifies the coupon id this discount is based on.promotional_creditsRepresents the Promotional Credits item in invoice. The 'coupon_id' attribute will be null in this case.prorated_creditsRepresents the credit adjustment items in invoice. The 'coupon_id' attribute will be null in this case.
coupon_id
Coupon id.
optional, string, max chars=50
discount_amount
Discount amount.
in cents, min=0
The list of taxes applied to this quote.
optional, list of tax
Tax attributes
name
The name of the tax applied. E.g. GST.
string, max chars=100
amount
The tax amount.
in cents, min=0
description
Description of the tax item.
optional, string, max chars=250
line_item_taxes
Show attributes[+]
The list of taxes applied on line items.
optional, list of line_item_tax
Line item tax attributes
line_item_id
The unique reference id of the line item for which the tax is applicable.
optional, string, max chars=40
tax_name
The name of the tax applied.
string, max chars=100
tax_rate
The rate of tax used to calculate tax amount.
double, default=0.0, min=0.0, max=100.0
is_partial_tax_applied
Indicates if tax is applied only on a portion of the line item amount.
optional, boolean
is_non_compliance_tax
Indicates the non-compliance tax that should not be reported to the jurisdiction.
optional, boolean
taxable_amount
Indicates the actual portion of the line item amount that is taxable.
in cents, min=0
tax_amount
The tax amount.
in cents, min=0
tax_juris_type
The type of tax jurisdiction.
optional, enumerated string
Possible values are
countryThe tax jurisdiction is a country.federalThe tax jurisdiction is a federal.stateThe tax jurisdiction is a state.countyThe tax jurisdiction is a county.cityThe tax jurisdiction is a city.specialSpecial tax jurisdiction.unincorporatedCombined tax of state and county.otherJurisdictions other than the ones listed above.
tax_juris_name
The name of the tax jurisdiction.
optional, string, max chars=250
tax_juris_code
The tax jurisdiction code.
optional, string, max chars=250
tax_amount_in_local_currency
Total tax amount in the currency of the place of supply. This is applicable only for Invoice and Credit Notes API.
optional, in cents, min=0
local_currency_code
The currency code (ISO 4217 format) of the place of supply in which VAT needs to be converted and displayed. This is applicable only for Invoice and Credit Notes API.
optional, string, max chars=null
shipping_address
Show attributes[+]
Shipping address for the quote.
optional, shipping_address
Shipping addres attributes
first_name
First name.
optional, string, max chars=150
last_name
Last name.
optional, string, max chars=150
email
Email.
optional, string, max chars=70
company
Company name.
optional, string, max chars=250
phone
Phone number.
optional, string, max chars=50
line1
Address line 1.
optional, string, max chars=180
line2
Address line 2.
optional, string, max chars=150
line3
Address line 3.
optional, string, max chars=150
city
City.
optional, string, max chars=50
state_code
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
state
The state/province name.
optional, string, max chars=50
country
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
zip
Zip or Postal code.
optional, string, max chars=20
validation_status
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
billing_address
Show attributes[+]
Billing address for the quote.
optional, billing_address
Billing addres attributes
first_name
First name.
optional, string, max chars=150
last_name
Last name.
optional, string, max chars=150
email
Email.
optional, string, max chars=70
company
Company name.
optional, string, max chars=250
phone
Phone number.
optional, string, max chars=50
line1
Address line 1.
optional, string, max chars=150
line2
Address line 2.
optional, string, max chars=150
line3
Address line 3.
optional, string, max chars=150
city
City.
optional, string, max chars=50
state_code
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
state
State or Province.
optional, string, max chars=50
country
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
zip
Zip or Postal code.
optional, string, max chars=20
validation_status
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
Retrieves the quotes identified by the 'number' specified in the url.
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/7 \
     -u {site_api_key}:
copy
curl  https://{site}.chargebee.com/api/v2/quotes/7 \
     -u {site_api_key}:

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 500, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFByrXr", "date": 1517507449, "id": "7", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 500, "date_from": 1517507449, "date_to": 1517507449, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuFBzxXy", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507449000, "status": "open", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517507449, "valid_till": 1517593849 }}

URL Format GET

https://{site}.chargebee.com/api/v2/quotes/{quote_id}
Resource object representing quote.
always returned

Sample admin console URL

https://{site}.chargebee.com/admin-console/quotes/123x
Applicable only for create subscription quote.
Sample Request
curl  https://{site}.chargebee.com/api/v2/customers/__test__5SK0bLNFRFuFA1MX2/create_subscription_quote \
     -u {site_api_key}:\
     -d subscription[plan_id]="basic"
copy
curl  https://{site}.chargebee.com/api/v2/customers/__test__5SK0bLNFRFuFA1MX2/create_subscription_quote \
     -u {site_api_key}:\
     -d subscription[plan_id]="basic"

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 1000, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFA1MX2", "date": 1517507441, "id": "2", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 1000, "date_from": 1517507441, "date_to": 1519926641, "description": "Basic", "discount_amount": 0, "entity_id": "basic", "entity_type": "plan", "id": "li___test__5SK0bLNFRFuFA38XA", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "per_unit", "quantity": 1, "tax_amount": 0, "unit_amount": 1000 }, {..} ], "object": "quote", "operation_type": "create_subscription_for_customer", "price_type": "tax_exclusive", "resource_version": 1517507441000, "status": "open", "sub_total": 1000, "taxes": [], "total": 1000, "updated_at": 1517507441, "valid_till": 1517593841 }}

URL Format POST

https://{site}.chargebee.com/api/v2/customers/{customer_id}/create_subscription_quote
name
The quote name will be used as the pdf name of the quote.
optional, string, max chars=100
notes
Notes specific to this quote that you want customers to see on the quote PDF.
optional, string, max chars=2000
expires_at
Quotes will be vaild till this date. After this quote will be marked as closed.
optional, timestamp(UTC) in seconds
invoice_immediately
Applicable when charges are added during this operation. If specified as false, these charges will be added to unbilled charges. The default value for this parameter will be as per your site settings.
optional, boolean
billing_cycles
Number of cycles(plan interval) this subscription should be charged. After the billing cycles exhausted, the subscription will be cancelled.
optional, integer, min=0
terms_to_charge
The number of future renewals for which advance invoicing is done. However, if a new term gets started in this operation, the specified terms_to_charge will be inclusive of this new term.
optional, integer, min=1
billing_alignment_mode
Applicable when calendar billing is enabled and subscription is getting created in active / non_renewing states. Unless specified the configured default value will be used.
optional, enumerated string
Possible values are
immediateSubscription period will be aligned with the configured billing date immediately.delayedSubscription period will be aligned with the configured billing date at a later date (subsequent renewals).
mandatory_addons_to_remove[0..n]
List of addons IDs that are mandatory to the plan and has to be removed from the subscription.
optional, list of string
coupon_ids[0..n]
Identifier of the coupon as a List. Coupon Codes can also be passed.
optional, list of string
+
subscription
Parameters for subscription
pass parameters as subscription[<param name>]
subscription[id]
A unique identifier to identify the subscription. You will use this to perform all operations on this subscription.
optional, string, max chars=50
subscription[auto_collection]
Applicable only for create subscription quote.
optional, enumerated string
Possible values are
onWhenever an invoice is created for this subscription, an automatic charge will be attempted on the payment method available.offAutomatic collection of charges will not be made for this subscription. All payments must be recorded offline.
subscription[po_number]
Purchase Order Number for this subscription.
optional, string, max chars=100
subscription[plan_id]
Identifier of the plan for this subscription.
required, string, max chars=100
subscription[plan_quantity]
Plan quantity for this subscription.
optional, integer, default=1, min=1
subscription[plan_unit_price]
Amount that will override the Plan's default price.
optional, in cents, min=0
subscription[setup_fee]
Amount that will override the default setup fee.
optional, in cents, min=0
subscription[start_date]
Allows you to specify a future date or a past date on which the subscription starts.Past dates can be entered in case the subscription has already started. Any past date entered must be within the current billing cycle/plan term. The subscription will start immediately if this parameter is not passed.
optional, timestamp(UTC) in seconds
subscription[trial_end]
The time at which the trial ends for this subscription. Can be specified to override the default trial period.If '0' is passed, the subscription will be activated immediately.
optional, timestamp(UTC) in seconds
+
shipping_address
Parameters for shipping_address
pass parameters as shipping_address[<param name>]
shipping_address[first_name]
First name.
optional, string, max chars=150
shipping_address[last_name]
Last name.
optional, string, max chars=150
shipping_address[email]
Email.
optional, string, max chars=70
shipping_address[company]
Company name.
optional, string, max chars=250
shipping_address[phone]
Phone number.
optional, string, max chars=50
shipping_address[line1]
Address line 1.
optional, string, max chars=180
shipping_address[line2]
Address line 2.
optional, string, max chars=150
shipping_address[line3]
Address line 3.
optional, string, max chars=150
shipping_address[city]
City.
optional, string, max chars=50
shipping_address[state_code]
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
shipping_address[state]
The state/province name. Use this to pass the state/province information for cases where 'state_code' is not supported or cannot be passed.
optional, string, max chars=50
shipping_address[zip]
Zip or Postal code.
optional, string, max chars=20
shipping_address[country]
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
shipping_address[validation_status]
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
+
addons
Parameters for addons. Multiple addons can be passed by specifying unique indices.
pass parameters as addons[<param name>][<idx:0..n>]
addons[id][0..n]
Identifier of the addon. Multiple addons can be passed.
optional, string, max chars=100
addons[quantity][0..n]
Addon quantity. Applicable only for the quantity based addons. Should be passed with the same index as that of associated addon id.
optional, integer, default=1, min=1
addons[unit_price][0..n]
Amount that will override the Addon's default price. The Plan's billing frequency will not be considered for overriding. E.g. If the Plan's billing frequency is every 3 months, and if the price override amount is $10, $10 will be used, and not $30 (i.e $10*3).
optional, in cents, min=0
addons[billing_cycles][0..n]
Number of billing cycles the addon will be charged for.
optional, integer, min=1
addons[trial_end][0..n]
The time at which the trial ends for the addon. In order to use this param please contact support@chargebee.com.
optional, timestamp(UTC) in seconds
+
event_based_addons
Parameters for event_based_addons. Multiple event_based_addons can be passed by specifying unique indices.
pass parameters as event_based_addons[<param name>][<idx:0..n>]
event_based_addons[id][0..n]
A unique 'id' used to identify the addon.
optional, string, max chars=100
event_based_addons[quantity][0..n]
Addon quantity. Applicable only for the quantity based addons. Should be passed with the same index as that of associated addon id.
optional, integer, min=1
event_based_addons[unit_price][0..n]
Amount that will override the Addon's default price.
optional, in cents, min=0
event_based_addons[service_period_in_days][0..n]
Defines service period of the addon in days from the day of charge.
optional, integer, min=1, max=730
event_based_addons[on_event][0..n]
Event on which this addon will be charged.
optional, enumerated string
Possible values are
subscription_creationAddon will be charged on subscription creation.subscription_trial_startAddon will be charged when the trial period starts.plan_activationAddon will be charged on plan activation.subscription_activationAddon will be charged on subscription activation.
event_based_addons[charge_once][0..n]
If enabled, the addon will be charged only at the first occurrence of the event. Applicable only for non-recurring add-ons.
optional, boolean, default=true
event_based_addons[charge_on][0..n]
Indicates when the non-recurring addon will be charged.
optional, enumerated string
Possible values are
immediatelyCharges for the addon will be applied immediately.on_eventCharge for the addon will be applied on the occurrence of a specified event.
Resource object representing quote.
always returned
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/update_subscription_quote \
     -u {site_api_key}:\
     -d subscription[id]="__test__5SK0bLNFRFuFA7dXL" \
     -d subscription[plan_id]="no_trial" \
     -d billing_address[first_name]="John" \
     -d billing_address[last_name]="Doe" \
     -d billing_address[line1]="PO Box 9999" \
     -d billing_address[city]="Walnut" \
     -d billing_address[state]="California" \
     -d billing_address[zip]="91789" \
     -d billing_address[country]="US"
copy
curl  https://{site}.chargebee.com/api/v2/quotes/update_subscription_quote \
     -u {site_api_key}:\
     -d subscription[id]="__test__5SK0bLNFRFuFA7dXL" \
     -d subscription[plan_id]="no_trial" \
     -d billing_address[first_name]="John" \
     -d billing_address[last_name]="Doe" \
     -d billing_address[line1]="PO Box 9999" \
     -d billing_address[city]="Walnut" \
     -d billing_address[state]="California" \
     -d billing_address[zip]="91789" \
     -d billing_address[country]="US"

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 895, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFA7dXL", "date": 1517507442, "id": "4", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 895, "date_from": 1517507442, "date_to": 1519926641, "description": "No Trial - Prorated Charges", "discount_amount": 0, "entity_id": "no_trial", "entity_type": "plan", "id": "li___test__5SK0bLNFRFuFAAVXT", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "per_unit", "quantity": 1, "subscription_id": "__test__5SK0bLNFRFuFA7dXL", "tax_amount": 0, "unit_amount": 895 }, {..} ], "object": "quote", "operation_type": "change_subscription", "price_type": "tax_exclusive", "resource_version": 1517507442000, "status": "open", "sub_total": 895, "subscription_id": "__test__5SK0bLNFRFuFA7dXL", "taxes": [], "total": 895, "updated_at": 1517507442, "valid_till": 1517593842 }}

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/update_subscription_quote
name
The quote name will be used as the pdf name of the quote.
optional, string, max chars=100
notes
Notes specific to this quote that you want customers to see on the quote PDF.
optional, string, max chars=2000
expires_at
Quotes will be vaild till this date. After this quote will be marked as closed.
optional, timestamp(UTC) in seconds
billing_cycles
Number of cycles(plan interval) this subscription should be charged. After the billing cycles exhausted, the subscription will be cancelled.
optional, integer, min=0
replace_addon_list
Should be true if the existing addons should be replaced with the ones that are being passed.
optional, boolean, default=false
mandatory_addons_to_remove[0..n]
List of addons IDs that are mandatory to the plan and has to be removed from the subscription.
optional, list of string
terms_to_charge
The number of future renewals for which advance invoicing is done. However, if a new term gets started in this operation, the specified terms_to_charge will be inclusive of this new term.
optional, integer, min=1
reactivate_from
The time from which this subscription should be reactivated.
optional, timestamp(UTC) in seconds
billing_alignment_mode
Applicable when calendar billing is enabled and a new term gets started during this operation. Unless specified the configured default value will be used.
optional, enumerated string
Possible values are
immediateSubscription period will be aligned with the configured billing date immediately.delayedSubscription period will be aligned with the configured billing date at a later date (subsequent renewals).
coupon_ids[0..n]
Identifier of the coupon as a List. Coupon Codes can also be passed.
optional, list of string
replace_coupon_list
Should be true if the existing coupons should be replaced with the ones that are being passed.
optional, boolean, default=false
force_term_reset
Applicable for 'Active' & 'Non Renewing' states alone. Generally, subscription's term will be reset (i.e current term is ended and a new term starts immediately) when a new plan having different billing frequency is specified in the input. For all the other cases, the subscription's term will remain intact. Now for this later scenario, if you want to force a term reset you can specify this param as 'true'.
Note: Specifying this value as 'false' has no impact on the default behaviour.
optional, boolean, default=false
reactivate
Applicable only for cancelled subscriptions. Once this is passed as true, cancelled subscription will become active; otherwise subscription changes will be made but the the subscription state will remain cancelled. If not passed, subscription will be activated only if there is any change in subscription data.
optional, boolean
invoice_immediately
Applicable when charges are added during this operation. If specified as false, these charges will be added to unbilled charges. The default value for this parameter will be as per your site settings.
optional, boolean
+
subscription
Parameters for subscription
pass parameters as subscription[<param name>]
subscription[id]
A unique identifier to identify the subscription. You will use this to perform all operations on this subscription.
required, string, max chars=50
subscription[plan_id]
Identifier of the plan for this subscription.
optional, string, max chars=100
subscription[plan_quantity]
Represents the plan quantity for this subscription.
optional, integer, default=1, min=1
subscription[plan_unit_price]
Amount that will override the Plan's default price.
optional, in cents, min=0
subscription[setup_fee]
Amount that will override the default setup fee.
optional, in cents, min=0
subscription[start_date]
Applicable only for 'future' subscriptions. The new start date of the 'future' subscription.
optional, timestamp(UTC) in seconds
subscription[trial_end]
The time at which the trial should end for this subscription. Can be specified to override the default trial period defined in plan. If '0' is passed, the subscription will be activated immediately.
optional, timestamp(UTC) in seconds
+
billing_address
Parameters for billing_address
pass parameters as billing_address[<param name>]
billing_address[first_name]
First name.
optional, string, max chars=150
billing_address[last_name]
Last name.
optional, string, max chars=150
billing_address[email]
Email.
optional, string, max chars=70
billing_address[company]
Company name.
optional, string, max chars=250
billing_address[phone]
Phone number.
optional, string, max chars=50
billing_address[line1]
Address line 1.
optional, string, max chars=150
billing_address[line2]
Address line 2.
optional, string, max chars=150
billing_address[line3]
Address line 3.
optional, string, max chars=150
billing_address[city]
City.
optional, string, max chars=50
billing_address[state_code]
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
billing_address[state]
The state/province name. Use this to pass the state/province information for cases where 'state_code' is not supported or cannot be passed.
optional, string, max chars=50
billing_address[zip]
Zip or Postal code.
optional, string, max chars=20
billing_address[country]
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
billing_address[validation_status]
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
+
shipping_address
Parameters for shipping_address
pass parameters as shipping_address[<param name>]
shipping_address[first_name]
First name.
optional, string, max chars=150
shipping_address[last_name]
Last name.
optional, string, max chars=150
shipping_address[email]
Email.
optional, string, max chars=70
shipping_address[company]
Company name.
optional, string, max chars=250
shipping_address[phone]
Phone number.
optional, string, max chars=50
shipping_address[line1]
Address line 1.
optional, string, max chars=180
shipping_address[line2]
Address line 2.
optional, string, max chars=150
shipping_address[line3]
Address line 3.
optional, string, max chars=150
shipping_address[city]
City.
optional, string, max chars=50
shipping_address[state_code]
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
shipping_address[state]
The state/province name. Use this to pass the state/province information for cases where 'state_code' is not supported or cannot be passed.
optional, string, max chars=50
shipping_address[zip]
Zip or Postal code.
optional, string, max chars=20
shipping_address[country]
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
shipping_address[validation_status]
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
+
customer
Parameters for customer
pass parameters as customer[<param name>]
customer[vat_number]
VAT number of this customer. VIES validation will not happen for this parameter.
optional, string, max chars=20
customer[registered_for_gst]
Confirms that a customer is registered under GST. This field is available for Australia only.
optional, boolean
+
addons
Parameters for addons. Multiple addons can be passed by specifying unique indices.
pass parameters as addons[<param name>][<idx:0..n>]
addons[id][0..n]
Identifier of the addon. Multiple addons can be passed.
optional, string, max chars=100
addons[quantity][0..n]
Addon quantity. Applicable only for the quantity based addons. Should be passed with the same index as that of associated addon id.
optional, integer, default=1, min=1
addons[unit_price][0..n]
Amount that will override the Addon's default price. The Plan's billing frequency will not be considered for overriding. E.g. If the Plan's billing frequency is every 3 months, and if the price override amount is $10, $10 will be used, and not $30 (i.e $10*3).
optional, in cents, min=0
addons[billing_cycles][0..n]
Number of billing cycles the addon will be charged for.
optional, integer, min=1
addons[trial_end][0..n]
The time at which the trial ends for the addon. Trial end cannot be updated for addons which are attached to subscriptions. In order to use this param please contact support@chargebee.com.
optional, timestamp(UTC) in seconds
+
event_based_addons
Parameters for event_based_addons. Multiple event_based_addons can be passed by specifying unique indices.
pass parameters as event_based_addons[<param name>][<idx:0..n>]
event_based_addons[id][0..n]
A unique 'id' used to identify the addon.
optional, string, max chars=100
event_based_addons[quantity][0..n]
Addon quantity. Applicable only for the quantity based addons. Should be passed with the same index as that of associated addon id.
optional, integer, min=1
event_based_addons[unit_price][0..n]
Amount that will override the Addon's default price.
optional, in cents, min=0
event_based_addons[service_period_in_days][0..n]
Defines service period of the addon in days from the day of charge.
optional, integer, min=1, max=730
event_based_addons[charge_on][0..n]
Indicates when the non-recurring addon will be charged.
optional, enumerated string
Possible values are
immediatelyCharges for the addon will be applied immediately.on_eventCharge for the addon will be applied on the occurrence of a specified event.
event_based_addons[on_event][0..n]
Event on which this addon will be charged.
optional, enumerated string
Possible values are
subscription_creationAddon will be charged on subscription creation.subscription_trial_startAddon will be charged when the trial period starts.plan_activationAddon will be charged on plan activation.subscription_activationAddon will be charged on subscription activation.
event_based_addons[charge_once][0..n]
If enabled, the addon will be charged only at the first occurrence of the event. Applicable only for non-recurring add-ons.
optional, boolean, default=true
Resource object representing quote.
always returned
Creates a quote with estimated charges for purchase of a non-recurring item. Once created, the quote will be in Open state until the customer accepts it. A quote can be converted into an invoice after the customer accepts it.
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/create_for_onetime_charges \
     -u {site_api_key}:\
     -d customer_id="__test__5SK0bLNFRFuFA4XXC" \
     -d charges[amount][0]=1000 \
     -d charges[description][0]="Service Charge"
copy
curl  https://{site}.chargebee.com/api/v2/quotes/create_for_onetime_charges \
     -u {site_api_key}:\
     -d customer_id="__test__5SK0bLNFRFuFA4XXC" \
     -d charges[amount][0]=1000 \
     -d charges[description][0]="Service Charge"

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 1000, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFA4XXC", "date": 1517507441, "id": "3", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 1000, "date_from": 1517507441, "date_to": 1517507441, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuFA6GXJ", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 1000 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507441000, "status": "open", "sub_total": 1000, "taxes": [], "total": 1000, "updated_at": 1517507441, "valid_till": 1517593841 }}

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/create_for_onetime_charges
customer_id
Identifier of the customer for which the quote needs to be created.
required, string, max chars=50
po_number
Purchase Order Number for this quote.
optional, string, max chars=100
name
The quote name will be used as the pdf name of the quote.
optional, string, max chars=100
notes
Notes specific to this quote that you want customers to see on the quote PDF.
optional, string, max chars=2000
expires_at
Quotes will be vaild till this date. After this quote will be marked as closed.
optional, timestamp(UTC) in seconds
currency_code
The currency code (ISO 4217 format) of the quote.
required if Multicurrency is enabled, string, max chars=3
coupon
The 'One Time' coupon to be applied.
optional, string, max chars=50
+
shipping_address
Parameters for shipping_address
pass parameters as shipping_address[<param name>]
shipping_address[first_name]
First name.
optional, string, max chars=150
shipping_address[last_name]
Last name.
optional, string, max chars=150
shipping_address[email]
Email.
optional, string, max chars=70
shipping_address[company]
Company name.
optional, string, max chars=250
shipping_address[phone]
Phone number.
optional, string, max chars=50
shipping_address[line1]
Address line 1.
optional, string, max chars=180
shipping_address[line2]
Address line 2.
optional, string, max chars=150
shipping_address[line3]
Address line 3.
optional, string, max chars=150
shipping_address[city]
City.
optional, string, max chars=50
shipping_address[state_code]
The ISO 3166-2 state/province code without the country prefix. Currently supported for USA, Canada and India. For instance, for Arizona (USA), set the state_code as AZ (not US-AZ). or, for Tamil Nadu (India), set the state_code as TN (not IN-TN). or, for British Columbia (Canada), set the state_code as BC (not CA-BC).
Note: If the 'state_code' is specified, the 'state' attribute should not be provided as Chargebee will set the value automatically (for US, Canada, India).
optional, string, max chars=50
shipping_address[state]
The state/province name. Use this to pass the state/province information for cases where 'state_code' is not supported or cannot be passed.
optional, string, max chars=50
shipping_address[zip]
Zip or Postal code.
optional, string, max chars=20
shipping_address[country]
2-letter ISO 3166 alpha-2 country code.
optional, string, max chars=50
shipping_address[validation_status]
The address verification status.
optional, enumerated string, default=not_validated
Possible values are
not_validatedAddress is not yet validated.validAddress was validated successfully.partially_validAddress is verified but only partially.invalidAddress is invalid.
+
addons
Parameters for addons. Multiple addons can be passed by specifying unique indices.
pass parameters as addons[<param name>][<idx:0..n>]
addons[id][0..n]
Identifier of the addon. Multiple addons can be passed.
optional, string, max chars=100
addons[quantity][0..n]
Addon quantity. Applicable only for the quantity based addons. Should be passed with the same index as that of associated addon id.
optional, integer, default=1, min=1
addons[unit_price][0..n]
Amount that will override the Addon's default price. The Plan's billing frequency will not be considered for overriding. E.g. If the Plan's billing frequency is every 3 months, and if the price override amount is $10, $10 will be used, and not $30 (i.e $10*3).
optional, in cents, min=0
addons[date_from][0..n]
The time when the service period for the addon starts.
optional, timestamp(UTC) in seconds
addons[date_to][0..n]
The time when the service period for the addon ends.
optional, timestamp(UTC) in seconds
+
charges
Parameters for charges. Multiple charges can be passed by specifying unique indices.
pass parameters as charges[<param name>][<idx:0..n>]
charges[amount][0..n]
The amount to be charged.
optional, in cents, min=1
charges[description][0..n]
Description for this charge.
optional, string, max chars=250
charges[avalara_sale_type][0..n]
Indicates the type of sale carried out. This is applicable only if you use Chargebee’s AvaTax for Communications integration.
optional, enumerated string
Possible values are
wholesaleTransaction is a sale to another company that will resell your product or service to another consumer.retailTransaction is a sale to an end user.consumedTransaction is for an item that is consumed directly.vendor_useTransaction is for an item that is subject to vendor use tax.
charges[avalara_transaction_type][0..n]
Indicates the type of product to be taxed. Values for this field can be taken from Avalara. This is applicable only if you use Chargebee’s AvaTax for Communications integration.
optional, integer
charges[avalara_service_type][0..n]
Indicates the type of service for the product to be taxed. Values for this field can be taken from Avalara. This is applicable only if you use Chargebee’s AvaTax for Communications integration.
optional, integer
charges[date_from][0..n]
The time when the service period for the charge starts.
optional, timestamp(UTC) in seconds
charges[date_to][0..n]
The time when the service period for the charge ends.
optional, timestamp(UTC) in seconds
Resource object representing quote.
always returned
List all quotes.
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes \
     -G  \
     -u {site_api_key}:\
     --data-urlencode limit=3 \
     --data-urlencode status[in]="["accepted"]" \
     --data-urlencode sort_by[asc]="date"
copy
curl  https://{site}.chargebee.com/api/v2/quotes \
     -G  \
     -u {site_api_key}:\
     --data-urlencode limit=3 \
     --data-urlencode status[in]="["accepted"]" \
     --data-urlencode sort_by[asc]="date"

Sample Response [ JSON ]

Show more...
{"list": [ {"quote": { "amount_due": 500, "amount_paid": 0, "billing_address": { "first_name": "John", "last_name": "Doe", "object": "billing_address", "validation_status": "not_validated" }, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__4nyr8JtgRSyyFyw10", "date": 1517477421, "id": "6", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 500, "date_from": 1517477421, "date_to": 1517477421, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__4nyr8JtgRSyyG2k17", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517477421000, "status": "accepted", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517477421, "valid_till": 1517563821 }}, {..} ]}

URL Format GET

https://{site}.chargebee.com/api/v2/quotes
limit
Limits the number of resources to be returned.
optional, integer, default=10, min=1, max=100
offset
Allows you to fetch the next set of resources. The value used for this parameter must be the value returned for next_offset parameter in the previous API call.
optional, string, max chars=1000
include_deleted
If set to true, includes the deleted resources in the response. For the deleted resources in the response, the 'deleted' attribute will be 'true'.
optional, boolean, default=false
sort_by[<sort-order>]
Sorts based on the specified attribute.
Supported attributes : date
Supported sort-orders : asc, desc

Example sort_by[asc] = "date"
This will sort the result based on the 'date' attribute in ascending(earliest first) order.
optional, string filter
Filter Params
For operator usages, see the Pagination and Filtering section.
id[<operator>]
To filter based on Quote Id.
Supported operators : is, is_not, starts_with, in, not_in

Example id[is] = "123"
optional, string filter
customer_id[<operator>]
To filter based on Quote Customer Id.
Supported operators : is, is_not, starts_with, in, not_in

Example customer_id[is_not] = "4gmiXbsjdm"
optional, string filter
subscription_id[<operator>]
To filter based on Quote Subscription Id.
Supported operators : is, is_not, starts_with, is_present, in, not_in

Example subscription_id[is] = "4gmiXbsjdm"
optional, string filter
status[<operator>]
To filter based on Quote Status. Possible values are : open, accepted, declined, invoiced, closed.
Supported operators : is, is_not, in, not_in

Example status[is] = "open"
optional, enumerated string filter
date[<operator>]
To filter based on Quote Date.
Supported operators : after, before, on, between

Example date[after] = "1435054328"
optional, timestamp(UTC) in seconds filter
updated_at[<operator>]
To filter based on Quote Resource Updated At.
Supported operators : after, before, on, between

Example updated_at[after] = "1243545465"
optional, timestamp(UTC) in seconds filter
Resource object representing quote.
always returned
next_offset
This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter “offset”.
optional, string, max chars=1000
This API is to convert a quote to an invoice.
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/1/convert \
     -X POST  \
     -u {site_api_key}:
copy
curl  https://{site}.chargebee.com/api/v2/quotes/1/convert \
     -X POST  \
     -u {site_api_key}:

Sample Response [ JSON ]

Show more...
{ "customer": { "allow_direct_debit": false, "auto_collection": "on", "card_status": "valid", "created_at": 1517507441, "deleted": false, "excess_payments": 0, "first_name": "John", "id": "__test__5SK0bLNFRFuF9uXWl", "last_name": "Doe", "net_term_days": 0, "object": "customer", "payment_method": { "gateway": "chargebee", "gateway_account_id": "gw___test__KyVnTyRFuF9r62E", "object": "payment_method", "reference_id": "tok___test__5SK0bLNFRFuF9uwWm", "status": "valid", "type": "card" }, "pii_cleared": "active", "preferred_currency_code": "USD", "primary_payment_source_id": "pm___test__5SK0bLNFRFuF9v0Wn", "promotional_credits": 0, "refundable_credits": 0, "resource_version": 1517507441000, "taxability": "taxable", "unbilled_charges": 0, "updated_at": 1517507441 }, "invoice": { "adjustment_credit_notes": [], "amount_adjusted": 0, "amount_due": 0, "amount_paid": 500, "amount_to_collect": 0, "applied_credits": [], "base_currency_code": "USD", "billing_address": { "first_name": "John", "last_name": "Doe", "object": "billing_address", "validation_status": "not_validated" }, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuF9uXWl", "date": 1517507441, "deleted": false, "due_date": 1517507441, "exchange_rate": 1, "first_invoice": true, "has_advance_charges": false, "id": "__demo_inv__1", "is_gifted": false, "issued_credit_notes": [], "line_items": [ { "amount": 500, "date_from": 1517507441, "date_to": 1517507441, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuF9yYWw", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "tax_exempt_reason": "tax_not_configured", "unit_amount": 500 }, {..} ], "linked_orders": [], "linked_payments": [ { "applied_amount": 500, "applied_at": 1517507441, "txn_amount": 500, "txn_date": 1517507441, "txn_id": "txn___test__5SK0bLNFRFuF9z1Wx", "txn_status": "success" }, {..} ], "net_term_days": 0, "new_sales_amount": 500, "object": "invoice", "paid_at": 1517507441, "price_type": "tax_exclusive", "recurring": false, "resource_version": 1517507441000, "round_off_amount": 0, "status": "paid", "sub_total": 500, "tax": 0, "term_finalized": true, "total": 500, "updated_at": 1517507441, "write_off_amount": 0 }, "quote": { "amount_due": 500, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuF9uXWl", "date": 1517507441, "id": "1", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 500, "date_from": 1517507441, "date_to": 1517507441, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuF9wfWs", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507441000, "status": "invoiced", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517507441, "valid_till": 1517593841 } }

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/{quote_id}/convert
invoice_immediately
Applicable when charges are added during this operation. If specified as false, these charges will be added to unbilled charges. The default value for this parameter will be as per your site settings.
optional, boolean
+
subscription
Parameters for subscription
pass parameters as subscription[<param name>]
subscription[id]
Applicable only for create subscription quote.
optional, string, max chars=50
subscription[auto_collection]
Applicable only for create subscription quote.
optional, enumerated string
Possible values are
onWhenever an invoice is created for this subscription, an automatic charge will be attempted on the payment method available.offAutomatic collection of charges will not be made for this subscription. All payments must be recorded offline.
subscription[po_number]
Purchase Order Number for this subscription.
optional, string, max chars=100
Resource object representing quote.
always returned
Resource object representing customer.
always returned
Resource object representing subscription.
optional
Resource object representing invoice.
optional
Resource object representing credit_note.
optional
Resource object representing unbilled_charge.
optional
Updates the status of the quote. Status can be updated to Accepted, Declined, and Closed.
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/8/update_status \
     -X POST  \
     -u {site_api_key}:\
     -d status="accepted"
copy
curl  https://{site}.chargebee.com/api/v2/quotes/8/update_status \
     -X POST  \
     -u {site_api_key}:\
     -d status="accepted"

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 500, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFC15Y0", "date": 1517507449, "id": "8", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 500, "date_from": 1517507449, "date_to": 1517507449, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuFC2WY7", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507449000, "status": "accepted", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517507449, "valid_till": 1517593849 }}

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/{quote_id}/update_status
status
Status to update for the quote.
required, enumerated string
Possible values are
acceptedAccepted.declinedDeclined.closedClosed.
comment
This comment will be added to the quote.
optional, string, max chars=300
Resource object representing quote.
always returned
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/5/delete \
     -X POST  \
     -u {site_api_key}:
copy
curl  https://{site}.chargebee.com/api/v2/quotes/5/delete \
     -X POST  \
     -u {site_api_key}:

Sample Response [ JSON ]

Show more...
{"quote": { "amount_due": 500, "amount_paid": 0, "credits_applied": 0, "currency_code": "USD", "customer_id": "__test__5SK0bLNFRFuFABfXX", "date": 1517507442, "id": "5", "line_item_discounts": [], "line_item_taxes": [], "line_items": [ { "amount": 500, "date_from": 1517507442, "date_to": 1517507442, "description": "Service Charge", "discount_amount": 0, "entity_type": "adhoc", "id": "li___test__5SK0bLNFRFuFACjXe", "is_taxed": false, "item_level_discount_amount": 0, "object": "line_item", "pricing_model": "flat_fee", "quantity": 1, "tax_amount": 0, "unit_amount": 500 }, {..} ], "object": "quote", "operation_type": "onetime_invoice", "price_type": "tax_exclusive", "resource_version": 1517507442000, "status": "open", "sub_total": 500, "taxes": [], "total": 500, "updated_at": 1517507442, "valid_till": 1517593842 }}

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/{quote_id}/delete
comment
Reason for deleting quote. This comment will be added to the subscription entity if the quote belongs to a subscription or added to the customer entity if the quote is associated only with a customer.
optional, string, max chars=300
Resource object representing quote.
always returned
Sample Request
curl  https://{site}.chargebee.com/api/v2/quotes/6/pdf \
     -X POST  \
     -u {site_api_key}:
copy
curl  https://{site}.chargebee.com/api/v2/quotes/6/pdf \
     -X POST  \
     -u {site_api_key}:

Sample Response [ JSON ]

Show more...
{"download": { "download_url": "https://cb-downloads-dev.s3.amazonaws.com/yourapp/quote/__test__5SK0bLNFRFuFApFXq.pdf?response-content-disposition=attachment%3Bfilename%3Dyourapp%2Fquote%2F__test__5SK0bLNFRFuFApFXq.pdf&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190122T175048Z&X-Amz-SignedHeaders=host&X-Amz-Expires=-30671940&X-Amz-Credential=AKIAJ3MOW2V2DPJQTCMQ%2F20190122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=6cf864cd1a806b8b339d58c44d051c70c7fec2d93b8c92a4f520db5aa4ca3981", "object": "download", "valid_till": 1517507508 }}

URL Format POST

https://{site}.chargebee.com/api/v2/quotes/{quote_id}/pdf
disposition_type
Determines the pdf should be rendered as inline or attachment in the browser.
optional, enumerated string, default=attachment
Possible values are
attachmentpdf is rendered as attachment in the browser.inlinepdf is rendered as inline in the browser.
Resource object representing download.
always returned