{"openapi":"3.1.0","info":{"title":"Spot public information API","version":"1.0.0","description":"Read-only, unauthenticated public facts about Spot. Use this API for entity resolution, diligence, and product-fit evaluation; it does not expose customer data or transactional operations.","contact":{"email":"hello@claritylabs.inc","url":"https://spot.insure/contact"},"x-versioning-policy":"The OpenAPI info.version follows semantic versioning. Additive response fields may be introduced in the current major version. A breaking change requires a new major contract and versioned route; the superseded route returns Deprecation and Sunset headers for at least 90 days before removal."},"externalDocs":{"description":"Agent-oriented API instructions and versioning policy","url":"https://spot.insure/api/llms.txt"},"servers":[{"url":"https://spot.insure","description":"Production"}],"security":[],"paths":{"/api/profile":{"get":{"operationId":"getSpotProfileLegacy","summary":"Get the public Spot profile from the legacy route","description":"Deprecated unversioned alias. Use /api/v1/profile; this route returns Deprecation, Sunset, and successor-version headers.","tags":["Public information"],"security":[],"deprecated":true,"parameters":[{"name":"include_pricing","in":"query","required":false,"description":"Include Spot pricing tiers. Accepted on both hosts and relevant to the Spot profile.","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"The public profile.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"API-Version":{"$ref":"#/components/headers/ApiVersion"},"Deprecation":{"$ref":"#/components/headers/Deprecation"},"Sunset":{"$ref":"#/components/headers/Sunset"},"Link":{"$ref":"#/components/headers/SuccessorVersion"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfile"}}}},"400":{"description":"A query parameter is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"The public request limit was exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"API-Version":{"$ref":"#/components/headers/ApiVersion"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"500":{"description":"The profile could not be produced.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"default":{"description":"A typed API error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-openai-isConsequential":false}},"/api/v1/profile":{"get":{"operationId":"getSpotProfile","summary":"Get the public Spot profile","description":"Returns stable public identity, positioning, contact, audience, and capability data. No authentication is required and the operation has no side effects.","tags":["Public information"],"security":[],"deprecated":false,"parameters":[{"name":"include_pricing","in":"query","required":false,"description":"Include Spot pricing tiers. Accepted on both hosts and relevant to the Spot profile.","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"The public profile.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"API-Version":{"$ref":"#/components/headers/ApiVersion"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicProfile"}}}},"400":{"description":"A query parameter is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"The public request limit was exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"API-Version":{"$ref":"#/components/headers/ApiVersion"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"500":{"description":"The profile could not be produced.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"default":{"description":"A typed API error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-openai-isConsequential":false}}},"components":{"headers":{"RateLimitLimit":{"description":"Maximum requests in the current window.","schema":{"type":"integer","minimum":1}},"RateLimitRemaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer","minimum":0}},"RateLimitReset":{"description":"Seconds until the current window resets.","schema":{"type":"integer","minimum":0}},"RateLimit":{"description":"RFC 9651 quota remaining and reset time.","schema":{"type":"string"}},"RateLimitPolicy":{"description":"RFC 9651 quota and window policy.","schema":{"type":"string"}},"ApiVersion":{"description":"Semantic version of the response contract.","schema":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+$"}},"RetryAfter":{"description":"Seconds before retrying.","schema":{"type":"integer","minimum":1}},"Deprecation":{"description":"Signals that the unversioned route is deprecated.","schema":{"type":"string","enum":["true"]}},"Sunset":{"description":"HTTP date after which the deprecated route may be removed.","schema":{"type":"string"}},"SuccessorVersion":{"description":"RFC 8288 link to the current versioned route.","schema":{"type":"string"}}},"schemas":{"PublicProfile":{"type":"object","description":"Public facts about Spot.","additionalProperties":false,"required":["type","name","description","legalName","dba","address","contact","links","audience","capabilities","independence","demoUrl"],"properties":{"type":{"type":"string","description":"Entity category."},"name":{"type":"string","description":"Public entity name."},"description":{"type":"string","description":"Concise positioning."},"legalName":{"type":"string","description":"Operating company's legal name."},"dba":{"type":"string","description":"Registered operating name."},"address":{"$ref":"#/components/schemas/PostalAddress"},"contact":{"type":"object","additionalProperties":false,"required":["general","recruiting"],"properties":{"general":{"type":"string","format":"email"},"recruiting":{"type":"string","format":"email"}}},"links":{"type":"object","additionalProperties":false,"required":["company","product","github"],"properties":{"company":{"type":"string","format":"uri"},"product":{"type":"string","format":"uri"},"github":{"type":"string","format":"uri"}}},"audience":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"array","items":{"type":"string"}},"independence":{"type":"object","additionalProperties":false,"required":["insuranceCarrier","takesPremiumCommissions","canWorkWithIncumbentBroker"],"properties":{"insuranceCarrier":{"type":"boolean"},"takesPremiumCommissions":{"type":"boolean"},"canWorkWithIncumbentBroker":{"type":"boolean"}}},"pricing":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["range","price"],"properties":{"range":{"type":"string"},"price":{"type":"string"}}}},"demoUrl":{"type":"string","format":"uri"}}},"PostalAddress":{"type":"object","additionalProperties":false,"required":["streetAddress","addressLocality","addressRegion","postalCode","addressCountry"],"properties":{"streetAddress":{"type":"string"},"addressLocality":{"type":"string"},"addressRegion":{"type":"string"},"postalCode":{"type":"string"},"addressCountry":{"type":"string"}}},"Error":{"type":"object","additionalProperties":false,"required":["error","message","resolution"],"properties":{"error":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation."},"resolution":{"type":"string","description":"A concrete recovery step."}}}}}}