{"openapi":"3.1.0","info":{"title":"The Zebra API (Bowmark)","version":"e833508f87ff","description":"US insurance comparison marketplace — side-by-side auto, home and renters rates from 100+ carriers, plus published rate research by state, city, vehicle, carrier and driver history. Its state rate research is live; the quote flows are still declarations. It does NOT quote life insurance: that surface is editorial only, measured 2026-08-01 (see getLifeQuotes).\n\nEvery function Bowmark has for The Zebra (thezebra.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/thezebra/getStateRates":{"post":{"operationId":"getStateRates","summary":"Returns what car insurance costs in a US state, from The Zebra's own rate research: the state average premium (6-month and monthly), the national average annual rate by year to compare it against, the","description":"Returns what car insurance costs in a US state, from The Zebra's own rate research: the state average premium (6-month and monthly), the national average annual rate by year to compare it against, the state's own annual average by year, and the per-carrier breakdown of minimum (liability) versus full coverage with the cheapest of each called out. Pass `{ state }` as a postal code (\"CA\") or a name (\"California\"); the 50 states and Washington, D.C. are covered, and anything else THROWS rather than returning an empty result, because a territory answered with zeroes reads as \"insurance is free here\". Every premium is USD over the term its field names — the site publishes 6-month and monthly per-carrier figures and a separate ANNUAL series, and the two are NOT interconvertible (California reads $1,224 per 6-month policy and $2,220 per year, not $2,448), so no annual per-carrier figure is derived. `byCarrier` is empty — not an error — for the states The Zebra publishes no carrier page for; `asOf` carries that page's own last-updated date so a caller can tell how fresh the numbers are. These are filed-rate averages for the site's standard driver profile, NOT a quote for the caller.\n\nCalls `bowmark.providers.thezebra.getStateRates`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraStateRates>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraStateRatesQuery","description":"TypeScript: `thezebraStateRatesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getStateRequirements":{"post":{"operationId":"getStateRequirements","summary":"Returns what a US state LEGALLY REQUIRES a driver to carry, as The Zebra's state-laws pages publish it: the liability minimums as three typed whole-dollar numbers (never the \"30/60/15\" string), every ","description":"Returns what a US state LEGALLY REQUIRES a driver to carry, as The Zebra's state-laws pages publish it: the liability minimums as three typed whole-dollar numbers (never the \"30/60/15\" string), every other mandated coverage the triple cannot express (personal injury protection, Michigan's $1m Property Protection Insurance), whether the state is no-fault, which coverages it leaves OPTIONAL, and the penalties for driving uninsured. Pass `{ state }` as a postal code (\"CA\") or a name (\"California\"); the 50 states and Washington, D.C. are covered and anything else THROWS. **A null liability figure means the state does not require that coverage AT ALL — it is not zero, and the difference is legal rather than cosmetic**: Florida is a no-fault state that mandates no bodily-injury liability whatsoever (it publishes its own notation as \"—/—/10\" and lists bodily injury under optional coverage), so `bodilyInjuryPerPerson: 0` would state a limit Florida does not set. The three figures are published only where the site's slash notation and its own dollar figures AGREE, and a contradiction throws rather than picking one. `requiredCoverages[].amount` is null where a coverage is a menu rather than a single minimum — Michigan offers six PIP levels including unlimited and an opt-out — and the site's wording is kept in `text` for every row. There is deliberately no `umUimRequired` boolean: uninsured-motorist is answered by which list it appears in, because on every state measured it is optional, so a `false` would be an untested default wearing the type of a checked fact. `asOf` carries the page's own last-updated date; these are the site's summary of state law, NOT legal advice and NOT a statute citation.\n\nCalls `bowmark.providers.thezebra.getStateRequirements`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraStateRequirements>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraStateRequirementsQuery","description":"TypeScript: `thezebraStateRequirementsQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getCityRates":{"post":{"operationId":"getCityRates","summary":"Returns what car insurance costs in a specific US CITY: the city's average 6-month premium, the state average this page compares it against, the per-carrier breakdown with the cheapest called out, and","description":"Returns what car insurance costs in a specific US CITY: the city's average 6-month premium, the state average this page compares it against, the per-carrier breakdown with the cheapest called out, and what an accident, claim or violation adds to the premium there. Pass `{ city, state }` — `state` is REQUIRED and not inferable, because The Zebra publishes a Springfield in three states and a Columbus in two. Both spellings of St./Saint and Ft./Fort resolve: the site itself publishes `st-louis` but `saint-paul`, and the caller's spelling is tried before the alternative. **A ZIP code is REFUSED rather than answered** — The Zebra's rating tool covers ~34,500 ZIPs but its published pages are city-level without exception (217 location URLs, not one with a ZIP, measured 2026-07-31), and since US rates are filed at ZIP granularity, returning a city average for a ZIP would state a city-wide figure at a precision the site does not rate. **Read `carrierRateBasis` before reading `byCarrier`**: the site serves two templates, one splitting full coverage from state minimum and one publishing a single BLENDED average across coverage levels, and the blended figure is not a full-coverage price — whichever fields the basis does not cover are null rather than filled with the nearest number. Roughly 165-200 of the largest US cities across 38 states have a page; every other city THROWS with a message saying so and pointing at `getStateRates`, because that is the site's coverage rather than a bad argument. All premiums are USD per 6-month policy; `averageMonthlyPremium` is populated only where the page prints it and is never divided out of the 6-month figure. These are filed-rate averages for the site's standard driver profile, NOT a quote for the caller.\n\nCalls `bowmark.providers.thezebra.getCityRates`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraCityRates>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraCityRatesQuery","description":"TypeScript: `thezebraCityRatesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getRatesByDriverProfile":{"post":{"operationId":"getRatesByDriverProfile","summary":"Returns how a driver's own circumstances move the premium, which is the question a state or city AVERAGE cannot answer: what each accident, claim or violation costs (21-23 incidents per state, from \"O","description":"Returns how a driver's own circumstances move the premium, which is the question a state or city AVERAGE cannot answer: what each accident, claim or violation costs (21-23 incidents per state, from \"One comp claim\" to a DUI, with the dollar increase over a clean record where the page prints it), what ONE at-fault accident costs PER CARRIER — the same insurer priced twice under two driver histories, which is the comparison that decides whether to switch after a claim — and, when a `city` is passed, what each age bracket and credit tier pays there. Pass `{ state }` as a postal code (\"CA\") or a name (\"California\"); add `{ city }` to unlock the age and credit axes. **The two axes are city-only and that is a measured fact about the site, not a limitation of this function**: full captures of the California and Texas state pages carry no age table and no credit table at all, while the city pages on The Zebra's blended template carry both — so `byAgeBracket` and `byCreditTier` are `[]` on a state-only call, and `warnings` always says why. **`byCreditTier` is deliberately stricter than a heading match**: a page whose credit section is published per-CARRIER (Saint Paul heads seven separate tables `Company | Avg. 6 Mo. Premium`, one of them the credit one) yields `[]` plus a warning rather than those rows, because \"which carrier is cheapest at one tier\" is a different question from \"what does my tier cost\" and returning one as the other is plausible-looking and wrong. Roughly 165-200 cities have a page; naming one that does not THROWS rather than quietly returning the state answer under the city you asked for. All premiums are USD per 6-month policy; `increaseAfterAtFaultAccident` is the only computed field and is a subtraction of two figures the same row publishes. `cleanRecordSixMonthPremium` is the state's \"None\" baseline and is null where the page omits that row (Texas prints it, California does not). These are The Zebra's filed-rate averages for standard profiles, NOT a quote for the caller.\n\nCalls `bowmark.providers.thezebra.getRatesByDriverProfile`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraDriverProfileRates>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraDriverProfileQuery","description":"TypeScript: `thezebraDriverProfileQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getVehicleRates":{"post":{"operationId":"getVehicleRates","summary":"Returns what it costs to insure one specific vehicle, from The Zebra's own rate research: the average annual premium PER MODEL YEAR and PER CARRIER with the cheapest of each year called out, the model","description":"Returns what it costs to insure one specific vehicle, from The Zebra's own rate research: the average annual premium PER MODEL YEAR and PER CARRIER with the cheapest of each year called out, the model's headline monthly figure and the body-style average it is compared against (\"the RAV4 averages $143/mo versus $184/mo for typical SUVs\"), and — on the minority of model pages that publish one — a per-state annual premium for this model across all 51 jurisdictions. Pass `{ make, model }` as a person writes them (\"Toyota\"/\"RAV4\", \"Mercedes-Benz\"/\"GLE\", \"Tesla\"/\"Model 3\"); the site's URL slug is derived here, verified against every make and model link on its own index. Add `{ year }` for one model year alone; a year the site does not publish THROWS and names the range it has, rather than returning an empty list a caller would read as \"this car is uninsurable\". **Every premium here is USD per YEAR, and that is a different term from every other function on this provider, which return 6-month figures — the two are not interconvertible and no conversion is done.** A TRIM is not a page: \"RAV4\" and \"RAV4 Hybrid\" are separate models the site rates, \"RAV4 XLE\" is not, and a make/model the site does not rate THROWS with the URL it tried, because that is the site's coverage rather than a bad argument. **These figures carry NO location**: they are US-wide averages, so they are not comparable with `getStateRates`/`getCityRates`, which price a state's or city's whole vehicle mix over 6 months — `byState` is the only located figure here and it is `[]`, with a warning saying so, on the model pages that publish no state table. `driverProfile` carries the page's own sentence naming which driver these rates price (measured: a full-coverage 30-year-old male with no violations), and it is returned rather than assumed because without it every number here is uninterpretable. These are filed-rate averages, NOT a quote for the caller.\n\nCalls `bowmark.providers.thezebra.getVehicleRates`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraVehicleRates>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraVehicleRatesQuery","description":"TypeScript: `thezebraVehicleRatesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getCarrierRates":{"post":{"operationId":"getCarrierRates","summary":"Returns what ONE named insurance company charges, which is the question a state or city average cannot answer: the carrier's own national average 6-month premium, the national benchmark The Zebra stat","description":"Returns what ONE named insurance company charges, which is the question a state or city average cannot answer: the carrier's own national average 6-month premium, the national benchmark The Zebra states it against ($1,162 as published), the per-carrier rate table its review page publishes, what THAT carrier charges after a claim or violation against its own clean-record baseline, and its by-age figures where the page carries them. Pass `{ carrier }` as the consumer brand — \"GEICO\", \"State Farm\", \"Wawanesa\"; matching is case- and punctuation-insensitive against the site's own roster of 81 carrier pages, and a name that matches SEVERAL is refused with the candidates rather than resolved to one, because returning another insurer's premiums under the name you asked for is wrong in a way that looks right. **Read `carrierRateBasis` before reading `byCarrier`**: the site serves two templates, one splitting state-minimum from full coverage over a 6-MONTH policy and one publishing a single blended MONTHLY average, and the fields the basis does not cover are null rather than filled with the nearest number — a monthly figure read as a 6-month one is a 6x error carrying an entirely plausible premium. `averageSixMonthPremium` and `nationalAverageSixMonthPremium` come from the page's own comparison sentence and are the two fields both templates publish, so they survive a template change the tables do not. **There is no per-state axis here and that is a measured fact about the site**: all 283 URLs in its insurance-companies sitemap are flat, with no per-carrier-per-state page — for \"what does GEICO cost in Texas\" call `getStateRates`, whose `byCarrier` slices the same research by geography. `byIncident` and `byAgeBracket` are `[]` — not an error — on the templates that publish neither, and `warnings` always says which axis was unavailable and why. These are The Zebra's filed-rate averages for its standard driver profile, NOT a quote for the caller.\n\nCalls `bowmark.providers.thezebra.getCarrierRates`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraCarrierRates>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraCarrierRatesQuery","description":"TypeScript: `thezebraCarrierRatesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getRentersQuotes":{"post":{"operationId":"getRentersQuotes","summary":"Returns REAL renters insurance quotes for one address — each carrier's own monthly premium, total premium, deductible, and its personal-property, personal-liability, medical-expenses and loss-of-use l","description":"Returns REAL renters insurance quotes for one address — each carrier's own monthly premium, total premium, deductible, and its personal-property, personal-liability, medical-expenses and loss-of-use limits, as The Zebra's quote funnel prices them. This is a priced offer for the person asking, NOT the published averages that `getStateRates` and its siblings return. Pass the address to insure and the renter's own `applicant` — `firstName`, `lastName`, `dob` (ISO YYYY-MM-DD) and `email`; the site refuses to price anything without them and bounces an incomplete funnel to its homepage. **It asks for NO phone number** — its own contact page says so in as many words — so this function takes none. **`advertisedCarriers` is not a quote list and must never be read as one**: the results page carries paid carrier placements alongside the real offers, and the site's own markup is what separates them, so the advertised names are returned in their own field with no price attached. An empty `quotes` array is a real answer meaning no carrier made a bindable offer for that address, and `warnings` says so. Every premium is USD and `monthlyPremium` is per MONTH — the card's own period is checked rather than assumed, and a card printing any other term THROWS instead of relabelling a figure. `totalPremium` is the site's own whole-term number and is never divided out of the monthly one. Renters is the only line The Zebra actually prices: its homeowners funnel reaches the same results page and publishes no premium anywhere on it.\n\nCalls `bowmark.providers.thezebra.getRentersQuotes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraRentersQuotes>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraRentersQuotesQuery","description":"TypeScript: `thezebraRentersQuotesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/thezebra/getAutoQuotes":{"post":{"operationId":"getAutoQuotes","summary":"Returns REAL auto insurance quotes for one driver and one vehicle at a US ZIP — each carrier's own monthly and six-month premium, deductible, and the coverage it priced, as The Zebra's auto quote funn","description":"Returns REAL auto insurance quotes for one driver and one vehicle at a US ZIP — each carrier's own monthly and six-month premium, deductible, and the coverage it priced, as The Zebra's auto quote funnel prices them. This is a priced offer for the person asking, NOT the published averages `getStateRates` and its siblings return. Pass `driver` (`firstName`, `lastName`, `dob` ISO YYYY-MM-DD, `email`, a real `employment` and `currentCarrier` — REQUIRED, see their own doc comments, never invented, same rule as a quote identity — and optionally `ageFirstLicensed`/`violations`/`occupation`/`residenceOwnership`/`creditScore`/`education`/`hasMilitaryAffiliation`/`insuredLength`, each defaulting to a clean-record, non-committal placeholder when omitted), one `vehicle` (`year`, `make`, `model`, and a real `garagingAddress` — REQUIRED, never invented, same rule as a quote identity — a model The Zebra does not rate THROWS naming the URL it tried), the 2-letter `state`, a 5-digit `zip`, `county` (the county the ZIP sits in — The Zebra validates it server-side and a missing or wrong county is bounced), and optionally `userPurchaseTimeframe`/`currentBodilyInjuryPerPerson`/`currentBodilyInjuryPerAccident` (`currentlyInsured` defaults `true` and `false` is refused — see its own doc comment). **Measured 2026-09-05: `driver.employment` and `driver.currentCarrier` are REQUIRED because the funnel's own `/car/manual/drivers/details/` page will not complete without a real answer to both, and neither has an honest default** — a call omitting either now throws immediately rather than discovering the same dead end after a full, ~60-90s funnel walk. **The write always binds** — the GraphQL gateway at `graphql-gateway.production.thezebra.com` accepts the seed and returns 200. **AS OF 2026-09-05 all six of the funnel's pages are answered and the results route is REACHED** — the last gate was never a missing mutation field: `/car/manual/coverage-selection/` computes personalized coverage packages on a THIRD backend (`coverage-service.production.thezebra.com`) and only unlocks the redirect once its own \"Show quotes at this coverage\" button PATCHes a chosen package, which this function now drives (the \"Best\" tier — the site's own recommended default). See the write site's own comment for the measured chain. **A separate, unresolved question**: with the funnel fully answered, the results page itself sometimes renders a legitimate-looking \"we checked with over 30 insurers and were unable to get any quotes for you … most insurance companies aren't selling new policies in your area due to temporary restrictions\" state instead of quote cards — reproduced on two (address, zip, county) pairs 200 miles apart with the same placeholder identity, so it does not look address-specific. Whether that is genuine carrier unavailability or a soft decline on this function's synthetic/proxied traffic is not yet determined; `agents/richard/problems/thezebra-getautoquotes-broken.md` carries the evidence. This function does NOT throw on that state — an empty `quotes` array is what it looks like, and `parseAutoResults` already treats a page with no `results-card_q2b_*` elements as a legitimate empty answer rather than an error, which is the correct call for a genuine carrier-side \"nothing to quote\" as well as this one. The function throws only when the funnel itself refuses to reach the coverage-selection or results routes, with a message naming the redirect target and, where readable, the funnel's own list of which pages are still unanswered. **`advertisedCarriers` is not a quote list and must never be read as one**: the results page would carry paid carrier placements alongside real offers, separated by `data-cy=\"results-card_ad_<carrier>\"` (ad) versus `data-cy=\"results-card_q2b_<carrier>\"` (real offer), and the advertised names are returned in their own field with no price attached. Every premium is USD and `monthlyPremium` is per MONTH — the card's own period is checked rather than assumed, and a card printing any other term THROWS instead of relabelling a figure. `totalPremium` is the site's own whole-term number and is never divided out of the monthly one.\n\nCalls `bowmark.providers.thezebra.getAutoQuotes`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<thezebraAutoQuotes>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/thezebraAutoQuotesQuery","description":"TypeScript: `thezebraAutoQuotesQuery`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"thezebraAutoDriver":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"dob":{"type":"string"},"email":{"type":"string"},"ageFirstLicensed":{"type":"number"},"violations":{"type":"object","properties":{"accidents":{"type":"number"},"claims":{"type":"number"},"tickets":{"type":"number"}},"required":["accidents","claims","tickets"],"additionalProperties":true},"occupation":{"type":"string"},"residenceOwnership":{"anyOf":[{"const":0},{"const":1},{"const":2},{"const":3}]}},"required":["firstName","lastName","dob","email"],"additionalProperties":true},"thezebraAutoQuotesQuery":{"type":"object","properties":{"driver":{"$ref":"#/components/schemas/thezebraAutoDriver"},"vehicle":{"$ref":"#/components/schemas/thezebraAutoVehicle"},"state":{"type":"string"},"zip":{"type":"string"},"county":{"type":"string"},"currentlyInsured":{"type":"boolean"},"userPurchaseTimeframe":{"anyOf":[{"const":"TODAY"},{"const":"FUTURE"}]}},"required":["driver","vehicle","state","zip","county"],"additionalProperties":true},"thezebraAutoVehicle":{"type":"object","properties":{"year":{"type":"number"},"make":{"type":"string"},"model":{"type":"string"}},"required":["year","make","model"],"additionalProperties":true},"thezebraCarrierRatesQuery":{"type":"object","properties":{"carrier":{"type":"string"}},"required":["carrier"],"additionalProperties":true},"thezebraCityRatesQuery":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"}},"required":["city","state"],"additionalProperties":true},"thezebraDriverProfileQuery":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"}},"required":["state"],"additionalProperties":true},"thezebraRentersApplicant":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"dob":{"type":"string"},"email":{"type":"string"}},"required":["firstName","lastName","dob","email"],"additionalProperties":true},"thezebraRentersQuotesQuery":{"type":"object","properties":{"address":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"}},"required":["street","city","state","zip"],"additionalProperties":true},"applicant":{"$ref":"#/components/schemas/thezebraRentersApplicant"},"livedHereFiveYears":{"type":"boolean"}},"required":["address","applicant"],"additionalProperties":true},"thezebraStateRatesQuery":{"type":"object","properties":{"state":{"type":"string"}},"required":["state"],"additionalProperties":true},"thezebraStateRequirementsQuery":{"type":"object","properties":{"state":{"type":"string"}},"required":["state"],"additionalProperties":true},"thezebraVehicleRatesQuery":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"number"}},"required":["make","model"],"additionalProperties":true}}}}