---
title: "List all quotes"
method: GET
path: "/quotes"
tags: ["Quotes"]
---

# List all quotes

`GET /quotes`

Returns a list of your quotes.

## Query parameters

- `createdEmail` string
- `onlyQuoteId` boolean
- `statuses` string[]

## Response `200`

OK

- ListAllQuotesResponse
  - `_embedded` object — Embedded wrapper containing the quotes array.
    - `quotes` object[] — Array of quote objects.
      - `id` string — Unique identifier for the quote.
      - `buyerGenerated` boolean — Indicates if the quote was created by the buyer.
      - `copyNotesToInvoice` boolean — Determines whether notes should be copied to the invoice.
      - `coupon` string, nullable — Coupon code applied to the quote, if any.
      - `created` string, date-time — Timestamp when the quote was created.
      - `createdBy` object — Information about the user who created this quote.
        - `company` string — Company name of the creator.
        - `email` string — Email address of the creator.
        - `first` string — First name of the creator.
        - `last` string — Last name of the creator.
        - `phone` string, nullable — Phone number of the creator.
        - `userId` string, nullable — Unique user ID associated with the creator, if available.
      - `currency` string — Currency code used in the quote.
      - `discount` number — Discount amount in base currency.
      - `discountDisplay` string — Formatted display of the discount in base currency.
      - `discountInPayoutCurrency` number — Discount amount in the payout currency.
      - `discountInPayoutCurrencyDisplay` string — Formatted display of the discount in the payout currency.
      - `expires` string, date-time — Timestamp when the quote expires.
      - `expirationDateDays` integer — Number of days until the quote expires.
      - `fulfillmentTerm` 'ON_PAYMENT' | 'ON_QUOTE_ACCEPTANCE' — Defines when the quote is fulfilled (e.g., ON_PAYMENT).
      - `items` object[] — Array of items included in the quote.
        - `product` string — Product identifier or name.
        - `attributes` object, nullable — Custom key-value pairs set on this quote item. Returns `null` when no attributes were set.
        - `customPrice` boolean — Indicates if the price is custom.
        - `display` string — Display name for the product.
        - `image` string, nullable — Image filename or URL, if applicable.
        - `intervalCount` string, nullable — Number of intervals (e.g., for a subscription).
        - `period` string, nullable — Billing period for the product (e.g., Monthly).
        - `periodDays` string, nullable — Number of days in the billing period.
        - `quantity` integer — Quantity of the product.
        - `renewIntoProducts` object[] — Array of product(s) into which this item can renew.
          - `renewIntoProductId` string — Product ID into which the item renews.
          - `renewIntoPath` string — Path or identifier for the renewing product.
          - `renewIntoPrice` number, float — Price for the renewing product.
          - `renewIntoPeriod` string — Period for the renewing product (e.g., Weekly, Monthly).
          - `renewIntoLevel` integer — Level or tier for the renewal.
          - `renewIntoIntervalCount` string — Interval count for the renewal (e.g., "2" months).
          - `renewIntoUpcomingProduct` string — Upcoming product name or handle after renewal.
        - `taxes` object[] — Tax details for this item.
          - `taxValue` number — Tax amount for this item.
          - `totalTaxable` number — Total taxable amount for this item.
        - `trialDays` integer, nullable — Number of trial days, if applicable.
        - `subscription` boolean — Indicates if the item is a subscription.
        - `unitTrialPrice` number — Trial price per unit, if applicable.
        - `trialPriceWithoutTax` number, nullable — Trial price without tax, if any.
        - `trialExtendedPrice` number, nullable — Extended price for the trial, if any.
        - `trialExtendedPriceWithoutTax` number, nullable — Extended trial price without tax.
        - `trialUnitTax` number, nullable — Tax per unit during trial.
        - `trialExtendedTax` number, nullable — Extended trial tax, if any.
        - `driver` string, nullable — Driver or source reference, if any.
        - `type` string, nullable — Additional type info.
        - `unitCouponDiscount` number — Discount per unit from a coupon.
        - `unitCouponDiscountDisplay` string — Display format of coupon discount per unit.
        - `unitCouponDiscountInPayoutCurrency` number — Coupon discount in the payout currency.
        - `unitCouponDiscountInPayoutCurrencyDisplay` string — Display format of the coupon discount in payout currency.
        - `unitDiscount` number — Amount of discount per unit in base currency.
        - `unitDiscountWithoutTax` number — Per-unit discount before tax.
        - `unitDiscountDisplay` string — Formatted display of the discount per unit.
        - `unitDiscountInPayoutCurrency` number — Per-unit discount in payout currency.
        - `unitDiscountInPayoutCurrencyDisplay` string — Display format of the discount in payout currency.
        - `unitListPrice` number — List price per unit in the base currency.
        - `unitListPriceDisplay` string — Formatted display of the list price per unit in base currency.
        - `unitListPriceInPayoutCurrency` number — Per-unit list price in payout currency.
        - `unitListPriceInPayoutCurrencyDisplay` string — Formatted display of the list price in payout currency.
        - `unitPrice` number — Final price per unit in base currency.
        - `unitPriceDisplay` string — Formatted display of the final unit price.
        - `unitPriceInPayoutCurrency` number — Final price per unit in the payout currency.
        - `unitPriceInPayoutCurrencyDisplay` string — Formatted display of the final unit price in payout currency.
        - `unitPriceWithoutTax` number — Final unit price without tax.
        - `unitPriceWithoutTaxDisplay` string — Formatted display of the unit price without tax.
        - `unitListPriceWithoutTax` number — Original list price per unit before tax.
        - `unitListPriceWithoutTaxDisplay` string — Formatted display of the list price before tax.
        - `grossModeOption` string, nullable — Gross mode option, if applicable.
        - `taxMode` string — Whether tax is NET or GROSS for this item.
        - `priceDetail` object — Detailed breakdown of the item's pricing.
          - `path` string — Identifier or path for this item's pricing context.
          - `quantity` integer — Quantity used for this price detail.
          - `plans` object[] — Array of plan objects associated with pricing.
            - `path` string — Plan's product path.
            - `interval` string — Interval name (e.g., month, year).
            - `intervalLength` integer — Number of intervals per billing cycle.
            - `prices` object[] — Detailed price lines for each plan.
              - …
        - `quantityBehavior` string — Determines how quantity changes are handled.
        - `quantityDefault` integer — Default quantity if none is specified.
        - `discountDuration` integer — Number of intervals the discount remains valid.
        - `cancellationChoice` string — Cancellation policy (e.g., AFTER_LAST_NOTIFICATION).
        - `startNewTerm` boolean — Whether a new subscription term should begin.
        - `subscriptionCancelDisabled` boolean — Indicates if subscription cancellation is disabled.
        - `notifications` object[] — Notification rules for different events.
          - `notificationType` string — Type of notification (e.g., PAYMENT_REMINDER).
          - `enabled` boolean — Indicates if the notification is enabled.
          - `intervals` object[] — Interval definitions for sending notifications.
            - `intervalUnit` string — Unit of interval (day, week, etc.).
            - `intervalLength` integer — Length of each interval.
            - `intervalCount` integer, nullable — Number of times to repeat, if applicable.
          - `firstIntervalUnit` string — Unit for the first notification interval.
          - `firstIntervalLength` integer — Length of the first interval.
          - `firstIntervalCount` integer, nullable — How many times the first interval repeats.
        - `productDescriptions` object — Localized display and summary of the product.
          - `display` object — Localized display text.
            - `en` string
          - `summary` object — Localized summary text.
            - `en` string
      - `name` string — Name or label for the quote.
      - `notes` string, nullable — Additional notes for the quote.
      - `netTermsDays` integer — Number of days for net payment terms.
      - `quoteUrl` string — URL to view or manage the quote.
      - `recipient` object — Recipient information for the quote.
        - `company` string, nullable — Recipient's company name, if any.
        - `email` string — Recipient's email address.
        - `first` string — Recipient's first name.
        - `last` string — Recipient's last name.
        - `phone` string — Recipient's phone number.
        - `userId` string, nullable — Unique user ID for the recipient, if any.
      - `recipientAddress` object — Address of the quote recipient.
        - `addressLine1` string — First line of the address.
        - `addressLine2` string, nullable — Second line of the address, if needed.
        - `city` string — City of the address.
        - `country` string — Country code or name.
        - `postalCode` string — Postal or ZIP code for the address.
        - `region` string — State or region.
      - `siteId` string — Identifier of the site associated with this quote.
      - `status` 'OPEN' | 'CANCELED' | 'AWAITING_PAYMENT' | 'COMPLETED' | 'EXPIRED' — Current status of the quote.
      - `statusHistory` object[] — Array of objects describing status transitions.
        - `statusUpdatedTo` string — The status to which the quote was updated.
        - `statusUpdatedByFullName` string — Full name of the person (or system) updating the status.
        - `statusUpdatedByEmail` string — Email of the user (or system) who updated the status.
        - `statusUpdatedOn` string, date-time — Timestamp of the status update.
      - `subtotal` number — Subtotal in base currency before discounts and tax.
      - `subtotalDisplay` string — Formatted display of the subtotal.
      - `subtotalInPayoutCurrency` number — Subtotal in the payout currency.
      - `subtotalInPayoutCurrencyDisplay` string — Formatted display of the subtotal in the payout currency.
      - `tags` object[] — Array of tag objects associated with the quote.
        - `key` string — The tag key or name.
        - `value` string — The tag value associated with this key.
      - `tax` number — Total tax amount in base currency.
      - `taxRate` number — Tax rate applied, if any.
      - `taxType` string — Type of tax applied (e.g., TAX, VAT).
      - `total` number — Final total in base currency, after discounts/tax.
      - `totalDisplay` string — Formatted display of the total amount.
      - `totalInPayoutCurrency` number — Total in the payout currency.
      - `totalInPayoutCurrencyDisplay` string — Formatted display of the total in payout currency.
      - `updated` string, date-time — Timestamp when the quote was last updated.
      - `taxId` string, nullable — Tax ID associated with the quote, if any.
      - `source` string — Source from which the quote was generated (e.g., MANAGER).
      - `sourceIP` string, nullable — IP address from which the quote was created or updated.
      - `orderReference` string, nullable — Reference to an associated order, if any.
      - `isGrossTax` boolean — Indicates whether the quote uses gross tax.
      - `invoiceId` string, nullable — Invoice ID associated with this quote, if any.

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header.
- `500` — Internal server error.

---

[API](https://skmtc.net/fastspring/apis/fastspring-api-accounts.md) · [All operations](https://skmtc.net/fastspring/apis/fastspring-api-accounts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fastspring/fastspring-api-accounts/versions/ae2f0b97db3e/schema)
