Quote

Preview

This schema is currently in preview and might change in the future.

We’re excited to hear your feedback and ideas. Please send an email to support@gigs.com to share your thoughts.

Quotes provide a preview of the invoices, including taxes and fees, that will occur when creating a subscription or add-on.

Name
object
Type
string
Description
Type of object is always quote.
Allowed values: quote
Name
id
Type
string
Description
Unique identifier for the quote.
Example: "quo_0SNlurA049MEWV2X9NicYieFQ4Kc"
Name
address
Type
nullable string
Description
The unique identifier for the address that the taxes were quoted for. Present when quoting local plans.
Example: "adr_0SNlurA049MEWV5ELDmnaqVXgTFT"
Name
createdAt
Type
string
Description
Time when the quote was created.
Example: "2024-01-09T15:00:51Z"
Name
discount
Type
object
Description
The total discount applied. This is the sum of the discounts of each line item.
Example: {"amount":100,"currency":"USD"}
Name
amount
Type
integer
Description
The price amount in the currency's minor unit, e.g. "cents" for many currencies.
Example: 999
>= 0
Name
currency
Type
string
Description
Three-letter ISO 4217 currency code. Must be a supported currency.
Example: "USD"
Name
expiredAt
Type
string
Description
The timestamp indicating when the quote expires. Set to 2 hours after the quote's creation time.
Example: "2024-02-01T11:12:13Z"
Name
fees
Type
array
Description
The fees for the quote.
Name
amount
Type
object
Description
The amount of the fee.
Example: {"amount":100,"currency":"USD"}
Optional: This property may not always be included.
Name
name
Type
string
Description
The name of the fee.
Optional: This property may not always be included.
Example: "Recovery Fee"
Name
type
Type
string
Description
The type of the fee.
Optional: This property may not always be included.
Allowed values: recoveryFee
Name
lineItems
Type
array
Description
The line items that make up the quote.
Name
subtotal
Type
object
Description
The total amount before any discounts, taxes or fees are applied.
Example: {"amount":999,"currency":"USD"}
Name
amount
Type
integer
Description
The price amount in the currency's minor unit, e.g. "cents" for many currencies.
Example: 999
>= 0
Name
currency
Type
string
Description
Three-letter ISO 4217 currency code. Must be a supported currency.
Example: "USD"
Name
tax
Type
object
Description
The total amount of taxes. This is the sum of the taxes of each line item.
Example: {"amount":200,"currency":"USD"}
Name
amount
Type
integer
Description
The price amount in the currency's minor unit, e.g. "cents" for many currencies.
Example: 999
>= 0
Name
currency
Type
string
Description
Three-letter ISO 4217 currency code. Must be a supported currency.
Example: "USD"
Name
taxExemptionReason
Type
nullable string
Description
The reason for the taxes not being calculated, if any. It can have one of the following values:

calculationFailed: The tax calculation failed for an unspecified reason.

inclusiveTaxExceedsPrice: The calculated tax is too large to be included in the price.

userExempted: The user is marked as exempted from taxes.
Example: "calculationFailed"
Allowed values: calculationFailed inclusiveTaxExceedsPrice userExempted
Name
total
Type
object
Description
The total amount after all discounts, taxes and fees are applied.
Example: {"amount":1199,"currency":"USD"}
Name
amount
Type
integer
Description
The price amount in the currency's minor unit, e.g. "cents" for many currencies.
Example: 999
>= 0
Name
currency
Type
string
Description
Three-letter ISO 4217 currency code. Must be a supported currency.
Example: "USD"
Name
user
Type
string
Description
The unique identifier for the user that this quote belongs to.
Example: "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
Name
voucher
Type
nullable string
Description
The unique identifier for the voucher applied to the quote, if any.
Example: "vou_0SNlurA049MEWV0h2jfjkdiOdplN"

Example

{
  "object": "quote",
  "id": "quo_0SNlurA049MEWV2X9NicYieFQ4Kc",
  "address": "adr_0SNlurA049MEWV5ELDmnaqVXgTFT",
  "createdAt": "2024-01-09T15:01:51.0Z",
  "discount": {
    "amount": 100,
    "currency": "USD"
  },
  "expiredAt": "2024-02-01T11:12:13.0Z",
  "fees": [
    {
      "amount": {
        "amount": 100,
        "currency": "USD"
      },
      "name": "Recovery Fee",
      "type": "recoveryFee"
    }
  ],
  "lineItems": [
    {
      "addon": "add_0SNlurA049MEWV4VxLfwJc7PJtHc",
      "discount": {
        "amount": 100,
        "currency": "USD"
      },
      "plan": "pln_0SNlurA049MEWV3V0q7gjQbM4EVo",
      "subtotal": {
        "amount": 999,
        "currency": "USD"
      },
      "tax": {
        "amount": 200,
        "currency": "USD"
      },
      "taxes": [
        {
          "amount": {
            "amount": 200,
            "currency": "USD"
          },
          "inclusive": false,
          "jurisdiction": "Federal",
          "name": "Federal TRS Fund"
        }
      ],
      "total": {
        "amount": 1099,
        "currency": "USD"
      }
    }
  ],
  "subtotal": {
    "amount": 999,
    "currency": "USD"
  },
  "tax": {
    "amount": 200,
    "currency": "USD"
  },
  "taxExemptionReason": "calculationFailed",
  "total": {
    "amount": 1199,
    "currency": "USD"
  },
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d",
  "voucher": "vou_0SNlurA049MEWV0h2jfjkdiOdplN"
}