{ "openapi": "3.1.0", "info": { "title": "Florida Insurance", "version": "0.4.0", "description": "Florida Insurance: Indicative US personal auto insurance prices for AI agents acting on behalf of a consumer in Florida, and a consented path to licensed agents. Call /v1/eligibility first. Read /v1/terms for the consent wording before /v1/contact.", "x-consent-version": "v1", "x-vertical": "auto-insurance" }, "servers": [ { "url": "https://flautoquotes.com" } ], "security": [], "paths": { "/v1/eligibility": { "post": { "summary": "Can we answer in this state, and how many licensed agents can take it", "operationId": "check_eligibility", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string", "description": "Two-letter US state code, e.g. NV" }, "product": { "type": "string", "enum": [ "auto" ], "default": "auto" } }, "required": [ "product" ] } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "More facts needed — body.elicitation says exactly what" } } } }, "/v1/quotes": { "post": { "summary": "indicative prices from the facts (only where licensed; otherwise the request is registered and a quote_id returned)", "operationId": "get_quotes", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "garaging_zip": { "type": "string", "description": "Five-digit ZIP where the vehicle is kept" }, "date_of_birth": { "type": "string", "format": "date" }, "years_licensed": { "type": "integer" }, "vehicle_year": { "type": "integer" }, "vehicle_make_model": { "type": "string" }, "annual_mileage": { "type": "integer" }, "violations_3yr": { "type": "integer" }, "coverage": { "type": "string", "enum": [ "state minimum", "standard", "full" ] }, "prior_continuous": { "type": "boolean" }, "state": { "type": "string", "description": "Optional; derived from the ZIP when absent" } }, "required": [ "garaging_zip", "date_of_birth", "vehicle_year", "vehicle_make_model", "coverage" ] } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "More facts needed — body.elicitation says exactly what" } } } }, "/v1/contact": { "post": { "summary": "With the consumer's explicit consent, connect them with up to 4 licensed agents", "operationId": "request_agent_contact", "x-openai-isConsequential": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "quote_id": { "type": "string", "description": "From get_quotes" }, "full_name": { "type": "string" }, "phone_number": { "type": "string", "description": "US mobile or landline" }, "email_address": { "type": "string" }, "preferred_channel": { "type": "string", "enum": [ "phone", "sms", "email" ] }, "best_time": { "type": "string" }, "street_address": { "type": "string", "description": "Optional. Lets a licensed agent answer firm." }, "verify_token": { "type": "string", "description": "Optional. From POST /v1/verify/check after the consumer enters the code texted to them. A verified number sells at the verified price and is contacted first." }, "consent": { "type": "object", "properties": { "granted": { "type": "boolean", "description": "true only if the human agreed to the presented text" }, "scope": { "type": "string", "enum": [ "contact_consumer", "sell_identity" ], "default": "contact_consumer" }, "text": { "type": "string", "description": "The exact words the consumer agreed to" }, "version": { "type": "string", "description": "Or \"v1\" to adopt our standard text from data_use_terms" }, "evidence": { "type": "object", "description": "Optional proof, e.g. a call recording id", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "url": { "type": "string" } } } }, "required": [ "granted" ] } }, "required": [ "quote_id", "full_name", "phone_number", "consent" ] } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "More facts needed — body.elicitation says exactly what" } } } }, "/v1/terms": { "get": { "summary": "Data-use terms and the consent text to present verbatim", "operationId": "data_use_terms", "x-openai-isConsequential": false, "responses": { "200": { "description": "Terms" } } } }, "/v1/verify/start": { "post": { "summary": "Text a one-time code to the consumer's phone (prove the number before it is sold)", "operationId": "verify_start", "x-openai-isConsequential": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "phone_number": { "type": "string" } }, "required": [ "phone_number" ] } } } }, "responses": { "200": { "description": "Code sent" }, "503": { "description": "Verification not configured on this deployment" } } } }, "/v1/verify/check": { "post": { "summary": "Check the code; returns a verify_token to pass with the contact request", "operationId": "verify_check", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "phone_number": { "type": "string" }, "code": { "type": "string" } }, "required": [ "phone_number", "code" ] } } } }, "responses": { "200": { "description": "Verified; body.token" }, "400": { "description": "Wrong or expired code" } } } }, "/consent-record/{lead_id}": { "get": { "summary": "The signed consent certificate for a lead (link is on every delivered lead); JSON with Accept: application/json", "operationId": "consent_record", "x-openai-isConsequential": false, "parameters": [ { "name": "lead_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "exp", "in": "query", "schema": { "type": "integer" } }, { "name": "sig", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Certificate" }, "403": { "description": "Bad signature" }, "410": { "description": "Link expired" } } } }, "/v1/forget": { "post": { "summary": "Revoke a request or lead by id", "operationId": "forget", "x-openai-isConsequential": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ] } } } }, "responses": { "200": { "description": "Forgotten" }, "404": { "description": "Unknown id" } } } }, "/v1/benchmark": { "get": { "summary": "Demand benchmark: how many requests, and the lowest indicative monthly price (p25/median/p75) for a state and coverage over 90 days. Aggregate only. Paid per call over x402 when payments are configured.", "operationId": "benchmark", "x-openai-isConsequential": false, "parameters": [ { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "coverage", "in": "query", "schema": { "type": "string", "enum": [ "state minimum", "standard", "full" ] } } ], "responses": { "200": { "description": "Benchmark" }, "402": { "description": "Payment required (x402)" } } } }, "/v1/prices": { "get": { "summary": "Price list and every payment method this deployment honours (x402, MPP, AP2, pay-per-crawl, prepaid credits, invoicing)", "operationId": "prices", "x-openai-isConsequential": false, "responses": { "200": { "description": "Prices" } } } }, "/v1/pull": { "get": { "summary": "Buyer pull of routed records (X-Buyer-Key). Metered and prepaid buyers receive HTTP 402 with every accepted payment method until paid.", "operationId": "pull_requests", "x-openai-isConsequential": false, "parameters": [ { "name": "X-Buyer-Key", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Records" }, "401": { "description": "Unknown key" }, "402": { "description": "Payment required (x402)" } } } }, "/v1/join": { "post": { "summary": "Register a licensed insurance agency to receive consented leads (the licensed contact confirms by email; nothing is delivered before)", "operationId": "register_agency", "x-openai-isConsequential": true, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "agency_name": { "type": "string" }, "npn": { "type": "string", "description": "NPN (National Producer Number). Your NPN is on your licence and at nipr.com. Digits only." }, "npn_state": { "type": "string", "description": "Two-letter state that issued the licence" }, "states": { "type": "array", "items": { "type": "string" }, "description": "Two-letter states the agency is appointed in; defaults to npn_state" }, "contact_name": { "type": "string", "description": "The licensed contact, who confirms by email" }, "contact_email": { "type": "string" }, "contact_phone": { "type": "string", "description": "US mobile" }, "rail": { "type": "string", "enum": [ "email", "webhook", "pull", "sms" ], "default": "email", "description": "How leads arrive: email, an https webhook (HMAC-signed), or pull by key over MCP/REST" }, "webhook_url": { "type": "string" }, "website": { "type": "string" }, "verify_token": { "type": "string", "description": "Optional: from POST /v1/verify/check after the contact enters the code texted to them" } }, "required": [ "agency_name", "npn", "npn_state", "contact_name", "contact_email", "contact_phone" ] } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "More facts needed — body.elicitation says exactly what" } } } }, "/v1/agency": { "get": { "summary": "A registered agency's status: states, rail, terms, founding period, queued and delivered counts, credit balance, licence verification", "operationId": "agency_status", "x-openai-isConsequential": false, "parameters": [ { "name": "X-Buyer-Key", "in": "header", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Status" }, "401": { "description": "Unknown key" } } } }, "/v1/dataset": { "get": { "summary": "The demand dataset: every auto insurance request people and their AI assistants made here, de-identified (age band, ZIP3, vehicle, coverage, mileage band, record, prices shown, the door and the AI vendor that asked, and the outcome: consented, verified, delivered, withdrawn). Never a name, phone, em", "operationId": "market_data", "x-openai-isConsequential": false, "parameters": [ { "name": "X-Buyer-Key", "in": "header", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } }, { "name": "since", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "until", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "door", "in": "query", "schema": { "type": "string" } }, { "name": "vendor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 1000, "maximum": 10000 } }, { "name": "offset", "in": "query", "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "Records, the price paid and the receipt" }, "402": { "description": "Payment required: price, preview count, every accepted method (x402, MPP, AP2, prepaid key)" } } } }, "/v1/topup": { "get": { "summary": "Buy prepaid lead credits by card: returns a Stripe Checkout URL to open for the human (X-Buyer-Key; amount 5-5000 USD)", "operationId": "topup", "x-openai-isConsequential": true, "parameters": [ { "name": "X-Buyer-Key", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "amount", "in": "query", "schema": { "type": "number", "default": 50 } } ], "responses": { "200": { "description": "body.url is the checkout link" }, "401": { "description": "Unknown key" }, "503": { "description": "No payment door" } } } } } }