---
title: "Find a quote"
method: GET
path: "/quotes/{identifier}"
---

# Find a quote

`GET /quotes/{identifier}`

## Path parameters

- `identifier` string, required

## Response `200`

quote successfully found

- GetQuoteResponse
  - `aggregate_limit` integer — The aggregate limit for the requested quote. Can be one of (100000, 250000, 500000, 750000, 1000000, 2000000, 3000000, 4000000, 5000000, 6000000, 7000000, 8000000, 9000000, 10000000); limits greater than 3000000 can be submitted but will not be quoted automatically
  - `aggregate_retention` integer — The desired retention on all sub limits for the requested quote. Can be one of (2500, 5000, 10000, 15000, 25000, 50000, 75000, 100000, 150000, 250000, 500000)
  - `client` ClientFields
    - `additional_contacts` AdditionalContactFields[]
      - `cell_phone` string — phone number of insured main contact
      - `contact_roles` string[], required — roles to be applied to additional contacts
      - `email` string, required — email address for the insured main contact
      - `first_name` string — first name
      - `last_name` string — last name
    - `address` AddressFields, required
      - `city` string, required — City
      - `state` string — State name or abbreviation. Must be a valid US state. Can be either full name or 2-letter abbreviation. Use “DC” for “Washington D.C.”
      - `street` string, required — street address for the applicant
      - `street2` string — Secondary Address information, if applicable
      - `zip` string, required — US postal/zip code
    - `broker_email` string, required — The broker's email, used to uniquely identify the broker of record for the applicant. Has to be an email of a broker known to the system (pre-configure with At-Bay)
    - `company_id` union — Unique company ID provided by At-Bay for the requested submission. client_partner_id values you generated using API v0.1 are valid inputs for the company_id field.
      - string
      - integer
    - `dba` string, nullable — DBA of the Applicant organization.
    - `domains` string[] — Applicant list of domains. All domains should be valid
    - `industry` string — Applicant’s industry code. We require 6-digit NAICS codes (https://www.naics.com/search/)
    - `insured_main_contact` InsuredMainContactFields
      - `cell_phone` string — phone number of insured main contact
      - `email` string, required — email address for the insured main contact
      - `first_name` string — first name
      - `last_name` string — last name
    - `name` string, required — Name of the Applicant organization. This is also known as the “Named Insured” in the policy
    - `revenue` integer, required — Applicant’s last 12 months revenue in USD
    - `secondary_broker_email` string, nullable — TBD
  - `company_id` string — Unique company ID provided by At-Bay for the requested submission. client_partner_id values you generated using API v0.1 are valid inputs for the company_id field.
  - `contingencies` ContingencyFields[]
    - `contingency_id` string
    - `status` 'open' | 'closed'
    - `text` string
    - `type` 'pre_bind' | 'post_bind'
  - `coverages` CoverageFields[]
    - `coverage_name` string
    - `limit` integer
    - `parameter` integer
    - `parameter_name` string
    - `retention` integer
  - `dates` PolicyDates
    - `effective` string, date, required — Desired effective date for the policy. Must be a valid date in yyyy-mm-dd format.
    - `expiration` string, date — Desired expiration date for the policy. Must be a valid date in yyyy-mm-dd format. In the absence of a submitted value, this value will be 12 months after the effective date by default. The difference between the effective and expiration dates must be greater than or equal to 6 months, and less than or equal to 18 months.
    - `mpl_retroactive_date` string — Desired retroactive date for the policy. Must be a valid date in yyyy-mm-dd or a case insensitive string of 'full_prior_acts'.
  - `error_occurred` boolean — Status of the question “did an error occur?”
  - `filing_effective_from` string, date — Starting filing date for the policy. Must be a valid date in yyyy-mm-dd format.
  - `filing_effective_until` string, date — Ending filing date for the policy. Must be a valid date in yyyy-mm-dd format.
  - `insurance_product` 'CYB' | 'TEO' | 'MPL' — The abbreviated name of the insurance product type for the requested quote. If the attribute is missing, we use CYB by default.
  - `per_claim_limit` integer — The per-claim limit for the requested quote. Can be one of (100000, 250000, 500000, 750000, 1000000, 2000000, 3000000, 4000000, 5000000, 6000000, 7000000, 8000000, 9000000, 10000000); in the absence of a submitted value, this value will match the aggregate limit by default. This value should not exceed the aggregate limit of the policy.
  - `per_claim_retention` integer — The desired retention on all sub limits for the requested quote. Can be one of (2500, 5000, 10000, 15000, 25000, 50000, 75000, 100000, 150000, 250000, 500000). Applies to MPL products.
  - `policy_number` string — Unique and official identifier of an At-Bay policy. Indicates coverage is active. Policy numbers are available after a successful bind request and can be released along with conditional binders, non-conditional binders, and policies.
  - `premium` integer — Premium for the returned quote in USD. Value is rounded to the nearest dollar.
  - `quote_expiration_date` string — The expiration date for this quote in YYYY-MM-DD format
  - `quote_identifier` string, required — unique identifier of the quote received after POST call, to be used in GET request. quote_id values you generated using API v0.1 are valid inputs for the quote_identifier field.
  - `quote_status` 'created' | 'aq_created' | 'calculating' | 'calc_completed' | 'broker_conflict_referral' | 'collection_issue' | 'red_flags_found' | 'calc_failed' | 'authority_failed' | 'eligible' | 'quick_scan_error' | 'missing_quick_scan' | 'aq_not_approved' | 'offer_email' | 'stale' | 'quote_referred' | 'published' | 'quote_declined' | 'quote_expired' | 'quote_revoked' | 'quote_bind_requested' | 'quote_not_bound' | 'policy_active' | 'policy_canceled' | 'policy_expired' — - quote_referred: quote request is pending and in our underwriting queue - quote_open: quote is valid and bindable - quote_declined: quote was declined by At-Bay - quote_expired: quote expiration date is in the past - quote_revoked: quote was once 'quote_open' but was revoked by At-Bay. This is usually either due to changes in the information about the insured or the result of underwriter discretion. - quote_bind_requested: bind request for this quote option is pending and in our underwriting queue - quote_not_bound: quote option is for an insured that had a bind request for a different quote option - policy_active: the policy is active and in force - policy_cancelled: the policy was cancelled - policy_expired: the policy expiration date is in the past.
  - `red_flags_exist` boolean — Status of the question: did the quick scan find any ‘red flags?’. Red Flags are severe vulnerabilities that cause referrals to our underwriting team.
  - `surcharges` SurchargesFields[]
    - `percentage` number, float
    - `price` number, float
    - `title` string
  - `surcharges_effective_from` string, date — Starting surcharges date for the policy. Must be a valid date in yyyy-mm-dd format.
  - `surcharges_effective_until` string, date — Ending surcharges date for the policy. Must be a valid date in yyyy-mm-dd format.

## Other responses

- `202` — quote not ready
- `400` — request does not exist
- `404` — quote not found

---

[API](https://skmtc.net/at-bay/apis/at-bay-partner-api.md) · [All operations](https://skmtc.net/at-bay/apis/at-bay-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/at-bay/at-bay-partner-api/revisions/f31fa8578dbb/schema)