{"openapi":"3.1.2","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"CoverIntent public-validation API","version":"1.0.0","summary":"CoverIntent is validating a consumer-controlled insurance-intent exchange for auto, home, and renters coverage.","description":"A person or licensed-agent prospect can submit one consent-bound, email-only validation-interest request and receive a non-secret confirmation code. The code confirms intake only and is never an access token. CoverIntent is a validation project operated by TheChattyAI. Neither CoverIntent nor TheChattyAI is presented as an insurer, insurance agency, carrier, broker, or licensed producer, and this service does not provide insurance or legal advice. That is the intended future consent model. The current CX1 release accepts validation interest only and does not select or contact insurers.","termsOfService":"https://coverintent.com/terms"},"servers":[{"url":"https://coverintent.com","description":"Current request origin"}],"externalDocs":{"description":"Human-readable developer and truth-boundary documentation","url":"https://coverintent.com/developers"},"tags":[{"name":"Discovery","description":"Read the exact capabilities and limits of CX1."},{"name":"Validation interest","description":"Submit consent-bound, email-only research, early-access, or partner interest. This is not an insurance quote request."}],"paths":{"/api/capabilities":{"get":{"operationId":"getCoverIntentCapabilities","summary":"Read public CX1 capabilities","tags":["Discovery"],"responses":{"200":{"description":"Canonical public capability document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityDocument"}}}}}}},"/api/interest":{"post":{"operationId":"submitCoverIntentValidationInterest","summary":"Submit email-only validation interest","description":"I agree that CoverIntent may use this information to contact me by email about research, early access, or a founding partnership. This is not a quote request. CoverIntent will not call or text me, contact an insurer, or sell or transfer this submission in CX1. Phone and sensitive insurance-application fields are rejected.","tags":["Validation interest"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestInput"}}}},"responses":{"201":{"description":"Interest accepted by the founder-tenant intake","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestSuccess"}}}},"400":{"description":"Invalid, unsupported, prohibited, or non-consented input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}},"403":{"description":"Cross-origin browser request rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}},"413":{"description":"Request body exceeds the maximum accepted size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}},"415":{"description":"Content-Type must be application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}},"429":{"description":"Founder-tenant intake rate limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}},"503":{"description":"Founder-tenant intake temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterestFailure"}}}}}}}},"components":{"schemas":{"InterestInput":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CoverIntent validation interest","description":"Minimum-necessary, email-only interest in CoverIntent research, early access, or a founding partnership. This is not an insurance quote request.","type":"object","additionalProperties":false,"required":["role","email","state","line","timeframe","priority","consent"],"properties":{"role":{"type":"string","enum":["consumer","agent"]},"email":{"type":"string","format":"email","maxLength":254},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY"]},"line":{"type":"string","enum":["auto","home","renters"]},"timeframe":{"type":"string","enum":["within_30_days","one_to_three_months","three_plus_months","exploring"]},"priority":{"type":"string","enum":["privacy_control","fewer_sales_calls","clear_choices","agent_ready_access"]},"consent":{"type":"boolean","const":true,"description":"I agree that CoverIntent may use this information to contact me by email about research, early access, or a founding partnership. This is not a quote request. CoverIntent will not call or text me, contact an insurer, or sell or transfer this submission in CX1."},"name":{"type":"string","minLength":1,"maxLength":80},"company":{"type":"string","minLength":1,"maxLength":120,"description":"Optional for role=agent; not accepted for role=consumer."},"website":{"type":"string","format":"uri","maxLength":200,"description":"Optional for role=agent; not accepted for role=consumer."},"companyFax":{"type":"string","maxLength":0,"description":"Spam-trap field. Human and agent clients must leave it empty."}},"allOf":[{"if":{"properties":{"role":{"const":"consumer"}},"required":["role"]},"then":{"properties":{"company":false,"website":false}}}]},"InterestSuccess":{"type":"object","additionalProperties":false,"required":["ok","confirmationCode","message"],"properties":{"ok":{"type":"boolean","const":true},"confirmationCode":{"type":"string","pattern":"^CI-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}$","description":"Stable, non-secret confirmation of the email-based CX1 intake. It is not an access token."},"message":{"type":"string"}}},"FieldIssue":{"type":"object","additionalProperties":false,"required":["field","message"],"properties":{"field":{"type":"string"},"message":{"type":"string"}}},"InterestFailure":{"type":"object","additionalProperties":false,"required":["ok","error"],"properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FieldIssue"}}}}}},"CapabilityDocument":{"type":"object","description":"Canonical projection of CoverIntent identity, truth boundary, accepted interest contract, capabilities, and interfaces.","required":["schemaVersion","identity","status","truthBoundary","acceptedInterest","capabilities","interfaces","protocolVersions"],"additionalProperties":true}}},"x-coverintent-truth-boundary":{"disclosure":"CoverIntent is a validation project operated by TheChattyAI. Neither CoverIntent nor TheChattyAI is presented as an insurer, insurance agency, carrier, broker, or licensed producer, and this service does not provide insurance or legal advice.","live":["Public information about the proposed CoverIntent consent model","Email-only consumer early-access interest","Email-only licensed-agent or agency partner interest","A non-secret confirmation code after the founder-tenant intake accepts a submission; it is never an access token","Public REST, OpenAPI, A2A, MCP, llms.txt, and web discovery surfaces for these exact validation capabilities"],"notLive":["Insurance quotes, comparisons, recommendations, underwriting, or eligibility decisions","Insurer, agency, or carrier matching or contact","Policy application, binding, purchase, payment, service, or claims handling","Lead sale, transfer, or disclosure to an insurer, agency, broker, or data buyer","Consumer phone calls, text messages, or automated nurture","Authenticated buyer-agent mandates or insurance transactions"],"prohibitedData":["Phone number","Date of birth","Social Security number","Driver's-license data","Vehicle identification number (VIN)","Health information","Payment or bank data","Policy or claim credentials"],"dataUse":"CX1 uses a submission only for CoverIntent research, early access, or founding-partner follow-up by email. Submissions are not sold or transferred to insurers, agencies, brokers, or data buyers. Limited service providers process the submitted email, name, or company only as needed to host the site, store the durable founder-tenant intake, and deliver the internal founder alert."},"x-coverintent-agent-interfaces":{"a2a":"https://coverintent.com/api/a2a","mcp":"https://coverintent.com/api/mcp","agentCard":"https://coverintent.com/.well-known/agent-card.json"}}