{"openapi":"3.1.0","info":{"title":"GEICO API (Bowmark)","version":"e833508f87ff","description":"Quotes and reads across GEICO's published catalogue — the vehicle lines it underwrites itself (auto, motorcycle, ATV, RV, boat, scooter, classic and Mexico auto, commercial auto), the property, specialty and small-business lines GEICO Insurance Agency places with third-party carriers, its local agent directory, its claim-status lookup, and the register of which partner actually writes each brokered line.\n\nEvery function Bowmark has for GEICO (geico.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/geico/getRentersQuote":{"post":{"operationId":"getRentersQuote","summary":"What GEICO charges to insure the contents of one rented home: the amount due today and the full term premium, the personal-property limit, deductible and liability limit the rate was struck at, the ot","description":"What GEICO charges to insure the contents of one rented home: the amount due today and the full term premium, the personal-property limit, deductible and liability limit the rate was struck at, the other limits on offer at that address, and WHICH carrier actually writes the policy. Pass `{ address, identity }` — the rented property, and the CALLER's own first name, last name and date of birth, exactly as they would type them into the site's own form. **The identity is a required argument because the flow's FIRST card demands it**: `propertysales.geico.com`'s keyless router does not place renters offsite, so the sales wizard is the only surface that prices it and there is no identity-free rating route to prefer. Nothing is defaulted and nothing is read from the environment. **`underwriter` is the field that makes this answer attributable rather than laundered**: GEICO BROKERS its property lines rather than underwriting them, so the premium is a partner's — measured 2026-08-01 in Austin TX, American Bankers Insurance Company of Florida wrote it, and the field is read from the card's own disclosure copy rather than hardcoded, because a partner change is exactly the thing a caller needs to see. It is the legal entity alone, which is what joins to the regulators' register via `bowmark.insurance.searchCarriers`. **A premium without its limits is unusable** — $190 at a $500 deductible and $190 at a $100 deductible are different products — so `coverage` carries what the rate was actually struck at and `options` carries the other limits on offer at that address, so a caller can re-ask instead of guessing which exist. `coverageStartDate` is optional: some sessions ask for it and some do not (the step order is A/B tested per session), and it falls back to the card's own prefilled value and then to today. Reading the price is the whole function — the continue action on the priced card is literally `Purchase`, and it is refused in code. Every amount is nullable and a null is never a zero.\n\nCalls `bowmark.providers.geico.getRentersQuote`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<geicoRentersQuote>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/RentersQuoteArgs","description":"TypeScript: `RentersQuoteArgs`"}},"required":["args"],"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/geico/listDiscounts":{"post":{"operationId":"listDiscounts","summary":"The discounts GEICO publishes for one line of business — each discount's name, GEICO's own description of what qualifies for it, and the saving it is advertised at where the site states one.","description":"The discounts GEICO publishes for one line of business — each discount's name, GEICO's own description of what qualifies for it, and the saving it is advertised at where the site states one. What a person reads to find out whether they are leaving money on the table WITHOUT starting a quote or handing over an identity: two keyless GETs, no browser, nothing submitted. Pass `{ line }` — one of `auto`, `motorcycle`, `multi-policy`, `organization-member`, `military`, `federal-employee`, `student`, `mature-driver`, `defensive-driver`, which are the categories GEICO's own discounts hub links to. **`advertisedSaving` is the field that keeps this honest**: GEICO mixes flat figures (\"you could receive a 5% discount\") with ceilings (\"save up to 22%\", \"up to a 15% discount\") in the same list, and most discounts publish no number at all — so `basis` is `flat` or `maximum` and says which kind it is, `text` keeps the site's own words, and a discount with no published figure is `null` rather than 0%. **Read `stateDependent` and `disclaimer` before treating any row as an entitlement.** GEICO publishes ONE national page per category — there is no state selector, no `state=` parameter and no state-scoped URL on the estate — so this returns a national list, and it is the site's own copy that qualifies it: `stateDependent` is true where THIS discount's description says it depends on the state you live in (6 of the 15 auto discounts do), and `disclaimer` is the page's verbatim availability notice (\"Some discounts, coverages, payment plans and features are not available in all states or all GEICO companies. Discount amount varies in some states.\"). Whether a specific person in a specific state actually gets a discount is a rating question this function deliberately does not answer — it reports what GEICO published. `informationCurrentAsOf` carries the site's own freshness stamp where it prints one, and `sourceUrl` the page actually read, resolved from the hub's links at call time so a moved path follows rather than 404s. An empty list is never returned: a category page that parses to nothing THROWS, because on this estate that means the markup was re-skinned, not that the discounts went away.\n\nCalls `bowmark.providers.geico.listDiscounts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GeicoDiscountList>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GeicoDiscountsArgs","description":"TypeScript: `GeicoDiscountsArgs`"}},"required":["args"],"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/geico/listPartnerCompanies":{"post":{"operationId":"listPartnerCompanies","summary":"Which company actually underwrites each of the 24 lines GEICO Insurance Agency BROKERS rather than writes itself — the read that tells an agent whose paper a \"GEICO\" home, life, pet, condo or business","description":"Which company actually underwrites each of the 24 lines GEICO Insurance Agency BROKERS rather than writes itself — the read that tells an agent whose paper a \"GEICO\" home, life, pet, condo or business policy is really on, since the price alone cannot answer that. GEICO underwrites its vehicle lines itself, so its own name never appears here; every row is a third-party or affiliated placement GEICO's own corporate directory publishes for exactly this purpose. One keyless GET, no browser, nothing submitted. Pass `{ line }` to narrow to one published category (case-insensitive, e.g. \"Renters Insurance\") or omit it for the whole register. **The shape has two levels because the site does**: `name` is the brand/agency GEICO places business with, and `underwrittenBy` is the page's own sub-list of the legal entities that brand actually writes through where it publishes one — a brand naming itself is not always the entity on the policy (Homeowners' \"Liberty Mutual\" placement alone lists 14 distinct underwriting companies). `underwrittenBy` is `[]` where the placement name IS the underwriting company, never invented. **`affiliated` is read from the page's own asterisk, never inferred** — GEICO's own legend: \"An asterisk (*) indicates an affiliated company, all others are non-affiliated,\" marking a Berkshire Hathaway sibling rather than an arm's-length third party. Cross-checked against this provider's own live data on three separate lines rather than trusted blind: `getRentersQuote` priced a real Austin TX policy underwritten by \"American Bankers Insurance Company of Florida\", and this function's Renters Insurance → Assurant placement lists that exact entity as one of its nine underwriters. A caller reconciling a quote's own `underwriter` field against this register should check both `name` and `underwrittenBy` — the site prices under either level depending on the line.\n\nCalls `bowmark.providers.geico.listPartnerCompanies`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GeicoPartnerCompanyList>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"args":{"$ref":"#/components/schemas/GeicoPartnerCompaniesArgs","description":"TypeScript: `GeicoPartnerCompaniesArgs`"}},"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/geico/findAgent":{"post":{"operationId":"findAgent","summary":"The GEICO local agents near a US location — each office's display name, the agent's own first and last name, street address, phone, opening hours, distance from the search centre and a link to their p","description":"The GEICO local agents near a US location — each office's display name, the agent's own first and last name, street address, phone, opening hours, distance from the search centre and a link to their page — which is the read a person needs when they want to buy through a person rather than a wizard. One keyless POST to GEICO's own locator, no browser, no identity, nothing submitted but a place name. Pass `{ zip }` or `{ location }`: **both work and neither is a fallback for the other** — `zip` takes a 5-digit ZIP, `location` takes free text (\"Chicago, IL\", a street address) which GEICO geocodes, so this answers a query State Farm's city-indexed directory and Progressive's ZIP-only locator each answer only half of. `radiusMiles` is 25, 50 or 100 — the only three radii GEICO's own form offers — and defaults to 50. `language: \"spanish\"` narrows to the offices GEICO staffs in Spanish, which is a real filter and not a cosmetic one (measured 2026-08-04 on ZIP 60601: 7 offices in English, 6 in Spanish). Agents come back nearest-first with GEICO's own `distanceMiles`. **Read `searchedFrom` before treating an empty `agents` as \"there is nobody near me\"** — the locator never rejects an unrecognised place, it geocodes loosely and searches wherever it lands, so the junk string \"zzzzzzqqq\" resolves to a point in Brazil and returns zero agents with a 200; `searchedFrom` is the coordinate it actually searched, and comparing it to what you asked for separates \"no agents there\" from \"that is not where you meant\". **An empty list is often the honest answer and is never an error**: GEICO publishes local-agent directories for 45 states and DC, and California, Mississippi, the Dakotas, Vermont, Wyoming and Alaska are not among them — ZIP 90001 at 100 miles really does return nothing. A response whose SHAPE is unrecognised throws instead, so a re-skin can never read as \"GEICO has no agents anywhere\". `details: true` additionally GETs each returned agent's own page for the lines they are appointed to write, the independent agency that owns the office, their email and the states they are licensed in — none of which the locator itself publishes. It costs one extra page read per agent RETURNED, so bound it with `limit`; a detail page that fails to load leaves that agent's `details` null rather than failing the search, **and names that page in `warnings`** — a null `details` otherwise means both \"this office publishes no page\" and \"this office's page refused us\", which are opposite facts and only the second is about us. An empty `warnings` is the healthy case. `soa`/`sob` are GEICO's own office codes, kept because they are what attributes a quote on `sales.geico.com` to this specific office.\n\nCalls `bowmark.providers.geico.findAgent`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<GeicoAgentSearch>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"$ref":"#/components/schemas/GeicoAgentQuery","description":"TypeScript: `GeicoAgentQuery`"},"limit":{"type":"number","description":"TypeScript: `number`"}},"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}}},"GeicoAgentQuery":{"type":"object","properties":{"zip":{"type":"string"},"location":{"type":"string"},"radiusMiles":{"anyOf":[{"const":25},{"const":50},{"const":100}]},"language":{"anyOf":[{"const":"english"},{"const":"spanish"}]},"details":{"type":"boolean"}},"additionalProperties":true},"GeicoDiscountsArgs":{"type":"object","properties":{"line":{"anyOf":[{"const":"auto"},{"const":"motorcycle"},{"const":"multi-policy"},{"const":"organization-member"},{"const":"military"},{"const":"federal-employee"},{"const":"student"},{"const":"mature-driver"},{"const":"defensive-driver"}]}},"required":["line"],"additionalProperties":true},"GeicoPartnerCompaniesArgs":{"type":"object","properties":{"line":{"type":"string"}},"additionalProperties":true},"QuoteIdentity":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"dob":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"required":["firstName","lastName","dob","email","phone"],"additionalProperties":true},"RentersQuoteArgs":{"type":"object","properties":{"address":{"type":"object","properties":{"street":{"type":"string"},"unit":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"}},"required":["street","city","state","zip"],"additionalProperties":true},"identity":{"$ref":"#/components/schemas/QuoteIdentity"},"leaseRequiresInsurance":{"type":"boolean"},"coverageStartDate":{"type":"string"}},"required":["address","identity"],"additionalProperties":true}}}}