Skip to main content

ServiceQuote

idstring<uuid>required

Quote id.

Example: 5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b
quoteNumberstringnullablerequired

Quote number.

Example: QT-000001
statusstringnullablerequired

Lifecycle status.

Possible values: [DRAFT, PENDING, SENT, VIEWED, ACCEPTED, APPROVED, REJECTED, EXPIRED, CONVERTED, CANCELLED, null]

customerIdstring<uuid>nullablerequired

The customer the quote is for.

Example: 9d2f6b1c-8e47-4a30-b5c2-0e1f3a4b5c6d
quoteDatestring<date-time>nullablerequired

Quote date.

Example: 2026-01-15T09:30:00.000Z
validUntilstring<date-time>nullablerequired

The quote is valid until this instant.

Example: 2026-01-15T09:30:00.000Z
currencystringnullablerequired

ISO 4217 currency code of every amount on the quote.

Example: USD
exchangeRatenumbernullablerequired

Rate from the document currency to the workspace currency.

Example: 1
subtotalnumbernullablerequired

Sum of the line values before discount and tax.

Example: 25
discountAmountnumbernullablerequired

Total discount.

Example: 0
taxAmountnumbernullablerequired

Total tax.

Example: 2.5
shippingAmountnumbernullablerequired

Shipping charge.

Example: 0
totalAmountnumbernullablerequired

Grand total in the document currency.

Example: 27.5
paymentTermsstringnullablerequired

Payment terms code.

Example: NET_30
convertedToSalesOrderIdstring<uuid>nullablerequired

The sales order this quote was converted into, once converted.

Example: 5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b
items object[]required

Quote lines.

  • Array [
    • productIdstring<uuid>nullablerequired

    Product id.

    Example: 5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b
    variantIdstring<uuid>nullablerequired

    Variant id.

    Example: 9d2f6b1c-8e47-4a30-b5c2-0e1f3a4b5c6d
    skustringnullablerequired

    Stock keeping unit.

    Example: SKU-1001
    namestringnullablerequired

    Line name.

    Example: Sample Widget
    quantitynumbernullablerequired

    Quantity.

    Example: 2
    uomIdstring<uuid>nullablerequired

    The unit the quantity is in.

    Example: 5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b
    unitPricenumbernullablerequired

    Unit price in the document currency.

    Example: 12.5
    discountPercentnumbernullablerequired

    Line discount percent.

    Example: 0
    discountAmountnumbernullablerequired

    Line discount amount in the document currency.

    Example: 0
    taxRatenumbernullablerequired

    Tax rate percent.

    Example: 10
    taxAmountnumbernullablerequired

    Tax on the line in the document currency.

    Example: 2.5
    totalAmountnumbernullablerequired

    Line total in the document currency.

    Example: 27.5
  • ]
    • updatedAtstring<date-time>nullablerequired

    When the quote last changed. Use the newest value as the next updatedAfter.

    Example: 2026-01-15T09:30:00.000Z
    ServiceQuote
    {
      "id": "5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b",
      "quoteNumber": "QT-000001",
      "status": "DRAFT",
      "customerId": "9d2f6b1c-8e47-4a30-b5c2-0e1f3a4b5c6d",
      "quoteDate": "2026-01-15T09:30:00.000Z",
      "validUntil": "2026-01-15T09:30:00.000Z",
      "currency": "USD",
      "exchangeRate": 1,
      "subtotal": 25,
      "discountAmount": 0,
      "taxAmount": 2.5,
      "shippingAmount": 0,
      "totalAmount": 27.5,
      "paymentTerms": "NET_30",
      "convertedToSalesOrderId": "5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b",
      "items": [
        {
          "productId": "5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b",
          "variantId": "9d2f6b1c-8e47-4a30-b5c2-0e1f3a4b5c6d",
          "sku": "SKU-1001",
          "name": "Sample Widget",
          "quantity": 2,
          "uomId": "5b0c8a6e-2f4d-4d6e-9a53-7c1d2e3f4a5b",
          "unitPrice": 12.5,
          "discountPercent": 0,
          "discountAmount": 0,
          "taxRate": 10,
          "taxAmount": 2.5,
          "totalAmount": 27.5
        }
      ],
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }