{"openapi":"3.1.0","info":{"title":"VesperSpatial Unified Commercial Underwriting & Actuarial API","description":"Full 4-Step Underwriting Lifecycle (Quote, Bind, Monitor, Cancel) powered by Delphi-1.0 Spatial Catastrophe Risk Model","version":"1.6.0"},"paths":{"/v1/occurrence/status":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Status","operationId":"occurrence_status_v1_occurrence_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/schedule":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Schedule","operationId":"occurrence_schedule_v1_occurrence_schedule_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Climate year for regional multipliers","default":2026,"title":"Year"},"description":"Climate year for regional multipliers"},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"Response format: json or csv","default":"json","title":"Format"},"description":"Response format: json or csv"},{"name":"prefer_seal","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Prefer Seal"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/season":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Season","operationId":"occurrence_season_v1_occurrence_season_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Climate year for June-1 bind score","title":"Year"},"description":"Climate year for June-1 bind score"},{"name":"region","in":"query","required":false,"schema":{"type":"string","description":"ca|north_interior|north_coast|south|all","default":"ca","title":"Region"},"description":"ca|north_interior|north_coast|south|all"},{"name":"prefer_seal","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Prefer Seal"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/freeze":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Freeze","operationId":"occurrence_freeze_v1_occurrence_freeze_get","parameters":[{"name":"as_of","in":"query","required":true,"schema":{"type":"string","description":"Calendar day YYYY-MM-DD for R4 freeze decision","examples":["2020-08-16"],"title":"As Of"},"description":"Calendar day YYYY-MM-DD for R4 freeze decision"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/brief/pdf":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Brief Pdf","operationId":"occurrence_brief_pdf_v1_occurrence_brief_pdf_get","parameters":[{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Calendar day YYYY-MM-DD for executive PDF brief (default today UTC)","examples":["2020-08-16"],"title":"As Of"},"description":"Calendar day YYYY-MM-DD for executive PDF brief (default today UTC)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/book":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Book","operationId":"occurrence_book_v1_occurrence_book_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/portfolio/evaluate":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Portfolio Evaluate","operationId":"occurrence_portfolio_evaluate_v1_occurrence_portfolio_evaluate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioEvaluateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/portfolio/zero-knowledge-evaluate":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Portfolio Zk Evaluate","operationId":"occurrence_portfolio_zk_evaluate_v1_occurrence_portfolio_zero_knowledge_evaluate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroKnowledgeEvaluateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/features":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Features","operationId":"occurrence_features_v1_occurrence_features_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","description":"ca|north_interior|north_coast|south","default":"ca","title":"Region"},"description":"ca|north_interior|north_coast|south"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","maximum":2100,"minimum":2000,"default":2021,"title":"Year"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"As Of"},"description":"YYYY-MM-DD"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/occurrence/replay":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Replay","operationId":"occurrence_replay_v1_occurrence_replay_get","parameters":[{"name":"skip_live_freeze","in":"query","required":false,"schema":{"type":"boolean","description":"Skip live nowcast freeze recompute (default true for fast ops UI)","default":true,"title":"Skip Live Freeze"},"description":"Skip live nowcast freeze recompute (default true for fast ops UI)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Occurrence Replay V1 Occurrence Replay Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/status":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Status","operationId":"occurrence_status_api_v1_occurrence_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/schedule":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Schedule","operationId":"occurrence_schedule_api_v1_occurrence_schedule_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Climate year for regional multipliers","default":2026,"title":"Year"},"description":"Climate year for regional multipliers"},{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"Response format: json or csv","default":"json","title":"Format"},"description":"Response format: json or csv"},{"name":"prefer_seal","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Prefer Seal"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/season":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Season","operationId":"occurrence_season_api_v1_occurrence_season_get","parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Climate year for June-1 bind score","title":"Year"},"description":"Climate year for June-1 bind score"},{"name":"region","in":"query","required":false,"schema":{"type":"string","description":"ca|north_interior|north_coast|south|all","default":"ca","title":"Region"},"description":"ca|north_interior|north_coast|south|all"},{"name":"prefer_seal","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Prefer Seal"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/freeze":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Freeze","operationId":"occurrence_freeze_api_v1_occurrence_freeze_get","parameters":[{"name":"as_of","in":"query","required":true,"schema":{"type":"string","description":"Calendar day YYYY-MM-DD for R4 freeze decision","examples":["2020-08-16"],"title":"As Of"},"description":"Calendar day YYYY-MM-DD for R4 freeze decision"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/brief/pdf":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Brief Pdf","operationId":"occurrence_brief_pdf_api_v1_occurrence_brief_pdf_get","parameters":[{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Calendar day YYYY-MM-DD for executive PDF brief (default today UTC)","examples":["2020-08-16"],"title":"As Of"},"description":"Calendar day YYYY-MM-DD for executive PDF brief (default today UTC)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/book":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Book","operationId":"occurrence_book_api_v1_occurrence_book_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/portfolio/evaluate":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Portfolio Evaluate","operationId":"occurrence_portfolio_evaluate_api_v1_occurrence_portfolio_evaluate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioEvaluateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/portfolio/zero-knowledge-evaluate":{"post":{"tags":["occurrence-decision-support"],"summary":"Occurrence Portfolio Zk Evaluate","operationId":"occurrence_portfolio_zk_evaluate_api_v1_occurrence_portfolio_zero_knowledge_evaluate_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroKnowledgeEvaluateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/features":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Features","operationId":"occurrence_features_api_v1_occurrence_features_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","description":"ca|north_interior|north_coast|south","default":"ca","title":"Region"},"description":"ca|north_interior|north_coast|south"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","maximum":2100,"minimum":2000,"default":2021,"title":"Year"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD","title":"As Of"},"description":"YYYY-MM-DD"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/occurrence/replay":{"get":{"tags":["occurrence-decision-support"],"summary":"Occurrence Replay","operationId":"occurrence_replay_api_v1_occurrence_replay_get","parameters":[{"name":"skip_live_freeze","in":"query","required":false,"schema":{"type":"boolean","description":"Skip live nowcast freeze recompute (default true for fast ops UI)","default":true,"title":"Skip Live Freeze"},"description":"Skip live nowcast freeze recompute (default true for fast ops UI)"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Occurrence Replay Api V1 Occurrence Replay Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health":{"get":{"summary":"Health Check","operationId":"health_check_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/geocode":{"get":{"summary":"Geocode Endpoint","description":"Resolves California address, ZIP code, or city to lat/lon, county, and match quality.","operationId":"geocode_endpoint_api_v1_geocode_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Address, ZIP code, or city in California","title":"Q"},"description":"Address, ZIP code, or city in California"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeocodeResponseSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/quote/pdf":{"post":{"summary":"Export Quote Slip Pdf","description":"Generates an official institutional ASOP 38 / Prop 103 Quote Slip PDF.","operationId":"export_quote_slip_pdf_api_v1_quote_pdf_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/property/risk-profile":{"post":{"summary":"Get Property Risk Profile","description":"HazardHub-Style Unified Property Risk Lookup across all 5 hazard domains.","operationId":"get_property_risk_profile_api_v1_property_risk_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyRiskProfileRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyRiskProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/underwrite/quote":{"post":{"summary":"Instant Underwriting Quote","description":"Step 1: Instant Multi-Hazard Risk Quote (Pre-bind rate check).","operationId":"instant_underwriting_quote_api_v1_underwrite_quote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnifiedQuoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponseSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/actuarial/quote/wildfire":{"post":{"summary":"Quote Wildfire Policy","operationId":"quote_wildfire_policy_api_v1_actuarial_quote_wildfire_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}},{"name":"explain","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Explain"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WildfireQuoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponseSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/actuarial/quote/flood":{"post":{"summary":"Quote Flood Policy","operationId":"quote_flood_policy_api_v1_actuarial_quote_flood_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dry_run","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dry Run"}},{"name":"explain","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Explain"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FloodQuoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponseSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/underwrite/bind":{"post":{"summary":"Bind Commercial Policy","description":"Step 2: Formal Policy Binding (Reserves PML capital against $25M spatial grid).","operationId":"bind_commercial_policy_api_v1_underwrite_bind_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyBindRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyBindResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/underwrite/policy/{policy_number}":{"get":{"summary":"Get Policy Telemetry","description":"Step 3: Live Policy Telemetry Risk Monitoring over 12-month term.","operationId":"get_policy_telemetry_api_v1_underwrite_policy__policy_number__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"policy_number","in":"path","required":true,"schema":{"type":"string","title":"Policy Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/underwrite/cancel":{"post":{"summary":"Cancel Commercial Policy","description":"Step 4: Cancel Policy & Release Spatial PML Capital back to grid.","operationId":"cancel_commercial_policy_api_v1_underwrite_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyCancelRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/register":{"post":{"summary":"Register Account","operationId":"register_account_api_v1_accounts_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountRegistrationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountRegistrationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/email/login":{"post":{"summary":"Login With Work Email","operationId":"login_with_work_email_api_v1_auth_email_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/accounts/usage":{"get":{"summary":"Get Account Usage","operationId":"get_account_usage_api_v1_accounts_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/keys/create":{"post":{"summary":"Create Api Key","operationId":"create_api_key_api_v1_keys_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/keys":{"get":{"summary":"List Api Keys","operationId":"list_api_keys_api_v1_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/keys/{key_id}":{"delete":{"summary":"Revoke Api Key","operationId":"revoke_api_key_api_v1_keys__key_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/keys/{key_id}/rotate":{"post":{"summary":"Rotate Api Key","operationId":"rotate_api_key_api_v1_keys__key_id__rotate_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agent/status":{"get":{"summary":"Get Agent Status","operationId":"get_agent_status_api_v1_agent_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/sandbox/underwrite/bind":{"post":{"summary":"Bind Paper Policy","description":"Paper Underwriting: Binds a simulated paper policy with $0 financial risk.","operationId":"bind_paper_policy_api_v1_sandbox_underwrite_bind_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaperBindRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/sandbox/simulate/catastrophe":{"post":{"summary":"Simulate Catastrophe Stress Test","description":"Catastrophe Stress-Testing: Triggers a simulated 1-in-100 yr event against paper portfolio.","operationId":"simulate_catastrophe_stress_test_api_v1_sandbox_simulate_catastrophe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatastropheSimulationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/sandbox/portfolio/analytics":{"get":{"summary":"Get Sandbox Portfolio Analytics","description":"Analytics: Returns real-time Paper Book of Business P&L, Loss Ratios, and Solvency Metrics.","operationId":"get_sandbox_portfolio_analytics_api_v1_sandbox_portfolio_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/payments/create-checkout-session":{"post":{"summary":"Create Payment Checkout Session","description":"Commercial Onboarding: Generates Stripe Checkout Session URL for carrier deposit.","operationId":"create_payment_checkout_session_api_v1_payments_create_checkout_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/billing/stripe/webhook":{"post":{"summary":"Stripe Webhook Listener","description":"Public Stripe Webhook Endpoint: Listens for payment completion and credits account balance.","operationId":"stripe_webhook_listener_api_v1_billing_stripe_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/payments/webhook":{"post":{"summary":"Stripe Webhook Listener","description":"Public Stripe Webhook Endpoint: Listens for payment completion and credits account balance.","operationId":"stripe_webhook_listener_api_v1_payments_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/billing/stripe/portal":{"post":{"summary":"Create Billing Customer Portal","description":"Generates a self-serve Stripe Customer Billing Portal session for managing cards & invoices.","operationId":"create_billing_customer_portal_api_v1_billing_stripe_portal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripePortalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/bordereau/upload-async":{"post":{"summary":"Submit Async Bordereau Job","description":"Commercial Batch Intake: Submits a multi-location CSV bordereau for async spatial underwriting.","operationId":"submit_async_bordereau_job_api_v1_bordereau_upload_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BordereauUploadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/jobs/{job_id}":{"get":{"summary":"Get Async Job Status","description":"Polls live processing status and catastrophe PML summary for an async batch job.","operationId":"get_async_job_status_api_v1_jobs__job_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}/results":{"get":{"summary":"Download Async Job Results","description":"Downloads the completed, enriched CSV bordereau with spatial hazard scores and PML calculations.","operationId":"download_async_job_results_api_v1_jobs__job_id__results_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/telegram":{"post":{"summary":"Telegram Webhook Listener","description":"Public Telegram Webhook Endpoint: Receives underwriting queries and dispatches indications.","operationId":"telegram_webhook_listener_api_v1_webhooks_telegram_post","parameters":[{"name":"X-Telegram-Bot-Api-Secret-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Telegram-Bot-Api-Secret-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sandbox/reset":{"post":{"summary":"Reset Sandbox Portfolio","description":"Resets Paper Underwriting Sandbox back to initial $10,000,000 Paper Surplus Capital.","operationId":"reset_sandbox_portfolio_api_v1_sandbox_reset_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api":{"get":{"summary":"Get Api Root","description":"API root — points clients at docs and the product UI hosts.","operationId":"get_api_root_api_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/v1/auth/google/login":{"get":{"summary":"Google Sso Login","description":"Google OAuth SSO: Generates Google Authorization Consent URL for Sign in with Google.","operationId":"google_sso_login_api_v1_auth_google_login_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional OAuth state token","title":"State"},"description":"Optional OAuth state token"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSSOLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/google/callback":{"get":{"summary":"Google Sso Callback Get","description":"Google OAuth SSO GET Redirect Callback: Processes Google authorization code, authenticates user, and redirects to Control Plane SPA.","operationId":"google_sso_callback_get_api_v1_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"id_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Token"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Google Sso Callback Post","description":"Google OAuth SSO POST Callback: Verifies Google ID token / Auth code for API clients.","operationId":"google_sso_callback_post_api_v1_auth_google_callback_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCallbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleUserSession"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/accounts/profile":{"get":{"summary":"Get Carrier Profile","description":"Corporate Identity: Fetches full legal corporate profile, NIPR licensing, and team members.","operationId":"get_carrier_profile_api_v1_accounts_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"summary":"Update Carrier Profile","description":"Corporate Identity: Updates corporate details, FEIN/NAIC codes, or authorized state lists.","operationId":"update_carrier_profile_api_v1_accounts_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]},"patch":{"summary":"Update Carrier Profile","description":"Corporate Identity: Updates corporate details, FEIN/NAIC codes, or authorized state lists.","operationId":"update_carrier_profile_api_v1_accounts_profile_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/settings":{"get":{"summary":"Get Tenant Settings","description":"Full Tenant & Profile Settings: Returns complete corporate identity, licensing, underwriting appetite, and webhook settings.","operationId":"get_tenant_settings_api_v1_accounts_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"summary":"Update Tenant Settings","description":"Updates full tenant settings, corporate profile, licensing, and underwriting appetite.","operationId":"update_tenant_settings_api_v1_accounts_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTenantSettingsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/me":{"get":{"summary":"Get Current Session User","description":"Session Profile: Returns active carrier user details, role, and current balance.","operationId":"get_current_session_user_api_v1_accounts_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/keys":{"get":{"summary":"List Carrier Api Keys","description":"API Keys: Lists all active and revoked API key tokens for current carrier tenant.","operationId":"list_carrier_api_keys_api_v1_accounts_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"summary":"Create Carrier Api Key","description":"API Keys: Generates a new scoped API key token for carrier servers or AI agents.","operationId":"create_carrier_api_key_api_v1_accounts_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/keys/{key_id}":{"delete":{"summary":"Revoke Carrier Api Key","description":"API Keys: Instantly revokes a carrier API key.","operationId":"revoke_carrier_api_key_api_v1_accounts_keys__key_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/accounts/billing/deposit":{"post":{"summary":"Create Stripe Billing Deposit","description":"Stripe Billing: Generates a Stripe Checkout Payment Session for carrier account balance top-up.","operationId":"create_stripe_billing_deposit_api_v1_accounts_billing_deposit_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/billing/checkout/complete":{"post":{"summary":"Complete Stripe Test Checkout","description":"Completes a Stripe Test Mode hosted checkout session and credits carrier deposit balance.","operationId":"complete_stripe_test_checkout_api_v1_accounts_billing_checkout_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteTestCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/underwrite/pml-reserve":{"get":{"summary":"Get Spatial Pml Reserves","description":"Spatial Solvency: Returns current 5-mile grid accumulated PML exposure against the $25,000,000 cap.","operationId":"get_spatial_pml_reserves_api_v1_underwrite_pml_reserve_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"latitude","in":"query","required":false,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"default":38.5025,"title":"Latitude"}},{"name":"longitude","in":"query","required":false,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"default":-122.4682,"title":"Longitude"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/accounts/team/members":{"get":{"summary":"List Team Members","description":"Team Identity: Lists all users and AI Agent Bots under corporate profile.","operationId":"list_team_members_api_v1_accounts_team_members_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"summary":"Add Team Member","description":"Team Identity: Adds a human team member or AI Agent Bot to corporate profile.","operationId":"add_team_member_api_v1_accounts_team_members_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddTeamMemberRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/audit-ledger":{"get":{"summary":"Get Tenant Audit Ledger","description":"Statutory Compliance Audit Ledger: Returns cryptographic API request metadata logs (ASOP 38 & NAIC #668).","operationId":"get_tenant_audit_ledger_api_v1_accounts_audit_ledger_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compliance/asop38-dossier":{"get":{"summary":"Get Asop38 Compliance Dossier","description":"Actuarial Standard of Practice (ASOP 38 & ASOP 56) Model Risk Governance Dossier.","operationId":"get_asop38_compliance_dossier_api_v1_compliance_asop38_dossier_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/compliance/audit-ledger/verify":{"get":{"summary":"Verify Tenant Audit Ledger Integrity","description":"Cryptographic Merkle Chain Verification under California Insurance Code § 1727.","operationId":"verify_tenant_audit_ledger_integrity_api_v1_compliance_audit_ledger_verify_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/accounts/team/invite":{"post":{"summary":"Invite Team Member","description":"Team Management: Invites a team member with role-based access control (RBAC).","operationId":"invite_team_member_api_v1_accounts_team_invite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInviteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/team/invite":{"post":{"summary":"Invite Team Member","description":"Team Management: Invites a team member with role-based access control (RBAC).","operationId":"invite_team_member_api_v1_team_invite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamInviteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/webhooks/deliveries":{"get":{"summary":"Get Webhook Deliveries","description":"Outbound PAS Webhook Deliveries: Retrieves real-time delivery logs, status, and HMAC signatures.","operationId":"get_webhook_deliveries_api_v1_webhooks_deliveries_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/payments/auto-recharge/configure":{"post":{"summary":"Configure Auto Recharge","description":"Configures automated Stripe balance top-up when account drops below threshold.","operationId":"configure_auto_recharge_api_v1_payments_auto_recharge_configure_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoRechargeConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/v1/support/tickets":{"post":{"summary":"Create Support Ticket","description":"Submits a commercial underwriting or technical support ticket.\nDispatches automated confirmation email via Resend and alerts engineering desk.","operationId":"create_support_ticket_api_v1_support_tickets_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"List Support Tickets","description":"Lists support tickets for the authenticated carrier account or email address.","operationId":"list_support_tickets_api_v1_support_tickets_get","parameters":[{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/support/ticket":{"post":{"summary":"Create Support Ticket","description":"Submits a commercial underwriting or technical support ticket.\nDispatches automated confirmation email via Resend and alerts engineering desk.","operationId":"create_support_ticket_api_v1_support_ticket_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/support/tickets/{ticket_id}":{"get":{"summary":"Get Support Ticket","description":"Retrieves full support ticket thread and messages.","operationId":"get_support_ticket_api_v1_support_tickets__ticket_id__get","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","title":"Ticket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/support/tickets/{ticket_id}/messages":{"post":{"summary":"Add Support Ticket Message","description":"Appends a client or underwriter response to an existing ticket.","operationId":"add_support_ticket_message_api_v1_support_tickets__ticket_id__messages_post","parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"string","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMessageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/spatial/topo":{"get":{"summary":"Get Spatial Topo","description":"Retrieves real-world USGS/Copernicus 3DEP DEM digital elevation slice\nfor any California zip code or geodetic coordinate pair.\nReturns 120x85 normalized elevation array (Base64) + physical terrain telemetry.","operationId":"get_spatial_topo_api_v1_spatial_topo_get","parameters":[{"name":"zip","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"5-digit US/California zip code","title":"Zip"},"description":"5-digit US/California zip code"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Centroid latitude","title":"Lat"},"description":"Centroid latitude"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Centroid longitude","title":"Lon"},"description":"Centroid longitude"},{"name":"zoom","in":"query","required":false,"schema":{"type":"integer","maximum":14,"minimum":9,"description":"Terrarium tile zoom level","default":11,"title":"Zoom"},"description":"Terrarium tile zoom level"},{"name":"cols","in":"query","required":false,"schema":{"type":"integer","maximum":160,"minimum":40,"description":"Mesh grid column resolution","default":120,"title":"Cols"},"description":"Mesh grid column resolution"},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":30,"description":"Mesh grid row resolution","default":85,"title":"Rows"},"description":"Mesh grid row resolution"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AccountRegistrationRequest":{"properties":{"company_name":{"type":"string","maxLength":120,"minLength":2,"title":"Company Name","example":"Swiss Re Commercial Lines MGA"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","example":"cuo@greenshieldrisk.com"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name","example":"Jane Underwriter"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","default":"Chief Underwriting Officer","example":"Chief Underwriting Officer"},"account_type":{"type":"string","title":"Account Type","default":"MGA_PARTNER","example":"MGA_PARTNER"},"tier":{"type":"string","title":"Tier","default":"GROWTH","example":"GROWTH"},"initial_deposit_usd":{"type":"number","maximum":10000000.0,"minimum":10.0,"title":"Initial Deposit Usd","default":500.0,"example":500.0}},"type":"object","required":["company_name"],"title":"AccountRegistrationRequest"},"AccountRegistrationResponse":{"properties":{"status":{"type":"string","title":"Status","default":"ACCOUNT_REGISTERED"},"account_id":{"type":"string","title":"Account Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"company_name":{"type":"string","title":"Company Name"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"tier":{"type":"string","title":"Tier"},"primary_key_id":{"type":"string","title":"Primary Key Id"},"issued_api_key":{"type":"string","title":"Issued Api Key"},"balance_usd":{"type":"number","title":"Balance Usd"},"monthly_quota_quotes":{"type":"integer","title":"Monthly Quota Quotes"},"message":{"type":"string","title":"Message","default":"Carrier tenant active. Store your Corporate Master API key securely."}},"type":"object","required":["account_id","company_name","tier","primary_key_id","issued_api_key","balance_usd","monthly_quota_quotes"],"title":"AccountRegistrationResponse"},"AddMessageRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"sender_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Email"}},"type":"object","required":["content"],"title":"AddMessageRequest"},"AddTeamMemberRequest":{"properties":{"full_name":{"type":"string","maxLength":80,"minLength":2,"title":"Full Name","example":"Jane Doe, FCAS"},"email":{"type":"string","maxLength":120,"minLength":5,"title":"Email","example":"jane.doe@twe-actuarial.com"},"role":{"type":"string","title":"Role","default":"ACTUARY","example":"ACTUARY"}},"type":"object","required":["full_name","email"],"title":"AddTeamMemberRequest"},"AgentFlagsSchema":{"properties":{"is_bindable":{"type":"boolean","title":"Is Bindable"},"is_dry_run":{"type":"boolean","title":"Is Dry Run"},"requires_mitigation":{"type":"boolean","title":"Requires Mitigation"},"pml_capacity_available_usd":{"type":"number","title":"Pml Capacity Available Usd"},"recommended_agent_action":{"type":"string","title":"Recommended Agent Action"}},"type":"object","required":["is_bindable","is_dry_run","requires_mitigation","pml_capacity_available_usd","recommended_agent_action"],"title":"AgentFlagsSchema"},"AutoRechargeConfigRequest":{"properties":{"threshold_usd":{"type":"number","maximum":10000.0,"minimum":10.0,"title":"Threshold Usd","default":50.0,"example":50.0},"recharge_amount_usd":{"type":"number","maximum":50000.0,"minimum":50.0,"title":"Recharge Amount Usd","default":500.0,"example":500.0}},"type":"object","title":"AutoRechargeConfigRequest"},"BillingReceiptSchema":{"properties":{"transaction_id":{"type":"string","title":"Transaction Id"},"fee_deducted_usd":{"type":"number","title":"Fee Deducted Usd"},"remaining_balance_usd":{"type":"number","title":"Remaining Balance Usd"},"account_quotes_consumed":{"type":"integer","title":"Account Quotes Consumed"}},"type":"object","required":["transaction_id","fee_deducted_usd","remaining_balance_usd","account_quotes_consumed"],"title":"BillingReceiptSchema"},"BookBody":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":2000.0,"title":"Year"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"Freeze as-of YYYY-MM-DD (default today)"},"zips":{"items":{"type":"string"},"type":"array","title":"Zips"},"zip_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Text","description":"Optional whitespace/CSV text with zip column"},"prefer_seal":{"type":"boolean","title":"Prefer Seal","default":true}},"type":"object","required":["year"],"title":"BookBody"},"BordereauUploadRequest":{"properties":{"csv_content":{"type":"string","title":"Csv Content","description":"Raw CSV string containing location schedules"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename","description":"Filename for the upload","default":"bordereau.csv"}},"type":"object","required":["csv_content"],"title":"BordereauUploadRequest"},"CatastropheSimulationRequest":{"properties":{"event_name":{"type":"string","title":"Event Name","default":"Napa Valley Wildfire 1-in-100 Yr Event","example":"Napa Wildfire Event"},"hazard_domain":{"type":"string","title":"Hazard Domain","default":"wildfire","example":"wildfire"},"epicenter_location":{"$ref":"#/components/schemas/LocationSchema"},"impact_radius_miles":{"type":"number","maximum":100.0,"minimum":1.0,"title":"Impact Radius Miles","default":15.0,"example":15.0},"severity_pct":{"type":"number","maximum":1.0,"minimum":0.01,"title":"Severity Pct","default":0.5,"example":0.5}},"type":"object","required":["epicenter_location"],"title":"CatastropheSimulationRequest"},"CompleteTestCheckoutRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"account_id":{"type":"string","title":"Account Id"},"amount_usd":{"type":"number","title":"Amount Usd"},"payment_method":{"type":"string","title":"Payment Method","default":"card_test_4242"},"cvc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cvc","default":"123"}},"type":"object","required":["session_id","account_id","amount_usd"],"title":"CompleteTestCheckoutRequest"},"CreateAPIKeyRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":2,"title":"Name","example":"Underwriting Production Agent Key"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes","example":["quote:wildfire","read:usage"]}},"type":"object","required":["name"],"title":"CreateAPIKeyRequest"},"CreateAPIKeyResponse":{"properties":{"status":{"type":"string","title":"Status","default":"API_KEY_GENERATED"},"key_id":{"type":"string","title":"Key Id"},"name":{"type":"string","title":"Name"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"issued_api_key":{"type":"string","title":"Issued Api Key"},"message":{"type":"string","title":"Message","default":"Store this API key securely now. It cannot be revealed again."}},"type":"object","required":["key_id","name","scopes","issued_api_key"],"title":"CreateAPIKeyResponse"},"CreateTicketRequest":{"properties":{"subject":{"type":"string","maxLength":200,"minLength":3,"title":"Subject"},"description":{"type":"string","minLength":5,"title":"Description"},"category":{"type":"string","title":"Category","description":"API_INTEGRATION, BORDEREAU_BATCH, BILLING_PAYMENTS, ACTUARIAL_HAZARD, GENERAL","default":"GENERAL"},"priority":{"type":"string","title":"Priority","description":"LOW, NORMAL, HIGH, CRITICAL","default":"NORMAL"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Name"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["subject","description"],"title":"CreateTicketRequest"},"CreateTicketResponse":{"properties":{"ticket_id":{"type":"string","title":"Ticket Id"},"status":{"type":"string","title":"Status"},"subject":{"type":"string","title":"Subject"},"category":{"type":"string","title":"Category"},"priority":{"type":"string","title":"Priority"},"created_at":{"type":"string","title":"Created At"},"message":{"type":"string","title":"Message"}},"type":"object","required":["ticket_id","status","subject","category","priority","created_at","message"],"title":"CreateTicketResponse"},"DomainRiskSummarySchema":{"properties":{"hazard_domain":{"type":"string","title":"Hazard Domain"},"risk_level":{"type":"string","title":"Risk Level"},"is_bindable":{"type":"boolean","title":"Is Bindable"},"monthly_premium_usd":{"type":"number","title":"Monthly Premium Usd"},"dynamic_multiplier":{"type":"number","title":"Dynamic Multiplier"},"kill_switch_triggered":{"type":"boolean","title":"Kill Switch Triggered"}},"type":"object","required":["hazard_domain","risk_level","is_bindable","monthly_premium_usd","dynamic_multiplier","kill_switch_triggered"],"title":"DomainRiskSummarySchema"},"EmailLoginRequest":{"properties":{"email":{"type":"string","maxLength":120,"minLength":3,"title":"Email","example":"cuo@greenshieldrisk.com"}},"type":"object","required":["email"],"title":"EmailLoginRequest"},"EmailLoginResponse":{"properties":{"status":{"type":"string","title":"Status","default":"LOGIN_SUCCESS"},"account_id":{"type":"string","title":"Account Id"},"user_id":{"type":"string","title":"User Id"},"company_name":{"type":"string","title":"Company Name"},"full_name":{"type":"string","title":"Full Name"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"tier":{"type":"string","title":"Tier"},"balance_usd":{"type":"number","title":"Balance Usd"},"monthly_quota_quotes":{"type":"integer","title":"Monthly Quota Quotes"},"issued_api_key":{"type":"string","title":"Issued Api Key"},"message":{"type":"string","title":"Message","default":"Authenticated successfully via verified work email."}},"type":"object","required":["account_id","user_id","company_name","full_name","email","role","tier","balance_usd","monthly_quota_quotes","issued_api_key"],"title":"EmailLoginResponse"},"ExplainabilityBreakdownSchema":{"properties":{"base_monthly_rate_usd":{"type":"number","title":"Base Monthly Rate Usd"},"dryness_loading_delta_usd":{"type":"number","title":"Dryness Loading Delta Usd"},"wind_gust_loading_delta_usd":{"type":"number","title":"Wind Gust Loading Delta Usd"},"mitigation_discount_delta_usd":{"type":"number","title":"Mitigation Discount Delta Usd"},"applied_loading_multiplier":{"type":"number","title":"Applied Loading Multiplier"}},"type":"object","required":["base_monthly_rate_usd","dryness_loading_delta_usd","wind_gust_loading_delta_usd","mitigation_discount_delta_usd","applied_loading_multiplier"],"title":"ExplainabilityBreakdownSchema"},"FloodQuoteRequest":{"properties":{"policy_id":{"type":"string","maxLength":64,"minLength":3,"title":"Policy Id","example":"POL_FL_2001"},"location":{"$ref":"#/components/schemas/LocationSchema"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","example":2000000.0},"elevation_ft_above_base_flood":{"type":"number","maximum":200.0,"minimum":-50.0,"title":"Elevation Ft Above Base Flood","default":2.0,"example":2.5},"sea_wall_or_levee_protected":{"type":"boolean","title":"Sea Wall Or Levee Protected","default":true,"example":true},"base_annual_rate":{"type":"number","maximum":0.2,"minimum":0.0001,"title":"Base Annual Rate","default":0.006,"example":0.006},"usgs_river_gauge_z":{"type":"number","maximum":10.0,"minimum":-5.0,"title":"Usgs River Gauge Z","default":1.0,"example":1.8},"nasa_grace_soil_moisture_sat":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Nasa Grace Soil Moisture Sat","default":0.6,"example":0.75},"radar_precip_rate_mm_hr":{"type":"number","maximum":500.0,"minimum":0.0,"title":"Radar Precip Rate Mm Hr","default":10.0,"example":15.0}},"type":"object","required":["policy_id","location","tiv_usd"],"title":"FloodQuoteRequest"},"GeocodeResponseSchema":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"formatted_address":{"type":"string","title":"Formatted Address"},"county":{"type":"string","title":"County"},"match_quality":{"type":"string","title":"Match Quality"}},"type":"object","required":["latitude","longitude","formatted_address","county","match_quality"],"title":"GeocodeResponseSchema"},"GoogleCallbackRequest":{"properties":{"id_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Token","example":"eyJhbGciOiJSUzI1NiIs..."},"auth_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Code","example":"4/0AfMhZ..."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","default":"Google Partner Carrier","example":"Swiss Re MGA Partner"}},"type":"object","title":"GoogleCallbackRequest"},"GoogleSSOLoginResponse":{"properties":{"auth_url":{"type":"string","title":"Auth Url","description":"Google OAuth 2.0 Authorization URL"},"client_id":{"type":"string","title":"Client Id","description":"Active Google OAuth Client ID"},"redirect_uri":{"type":"string","title":"Redirect Uri","description":"OAuth Redirect Callback URI"}},"type":"object","required":["auth_url","client_id","redirect_uri"],"title":"GoogleSSOLoginResponse"},"GoogleUserSession":{"properties":{"status":{"type":"string","title":"Status","default":"GOOGLE_SSO_SUCCESS","example":"GOOGLE_SSO_SUCCESS"},"user_id":{"type":"string","title":"User Id","example":"USR_GGL_12345"},"tenant_id":{"type":"string","title":"Tenant Id","example":"ACC_GGL_98765"},"company_name":{"type":"string","title":"Company Name","example":"Swiss Re MGA Partner"},"full_name":{"type":"string","title":"Full Name","example":"Conner Kupferberg"},"email":{"type":"string","title":"Email","example":"conner@vesperspatial.com"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","example":"https://lh3.googleusercontent.com/a/..."},"google_sub":{"type":"string","title":"Google Sub","example":"109283746591827364"},"issued_api_key":{"type":"string","title":"Issued Api Key","example":"vesper_master_9f8e7d6c..."},"auth_provider":{"type":"string","title":"Auth Provider","default":"GOOGLE_OAUTH","example":"GOOGLE_OAUTH"}},"type":"object","required":["user_id","tenant_id","company_name","full_name","email","google_sub","issued_api_key"],"title":"GoogleUserSession"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LocationSchema":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","example":38.3047},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","example":-122.2989}},"type":"object","required":["latitude","longitude"],"title":"LocationSchema"},"MessageItem":{"properties":{"message_id":{"type":"string","title":"Message Id"},"ticket_id":{"type":"string","title":"Ticket Id"},"sender_email":{"type":"string","title":"Sender Email"},"sender_type":{"type":"string","title":"Sender Type"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["message_id","ticket_id","sender_email","sender_type","content","created_at"],"title":"MessageItem"},"PaperBindRequest":{"properties":{"hazard_domain":{"type":"string","title":"Hazard Domain","default":"wildfire","example":"wildfire"},"location":{"$ref":"#/components/schemas/LocationSchema"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","example":2500000.0},"monthly_premium_usd":{"type":"number","minimum":1.0,"title":"Monthly Premium Usd","example":850.0}},"type":"object","required":["location","tiv_usd","monthly_premium_usd"],"title":"PaperBindRequest"},"PaymentCheckoutRequest":{"properties":{"amount_usd":{"type":"number","maximum":500000.0,"minimum":1.0,"title":"Amount Usd","default":500.0,"example":500.0}},"type":"object","title":"PaymentCheckoutRequest"},"PolicyBindRequest":{"properties":{"quote_policy_id":{"type":"string","title":"Quote Policy Id","example":"POL_WF_1001"},"hazard_domain":{"type":"string","title":"Hazard Domain","default":"wildfire","example":"wildfire"},"location":{"$ref":"#/components/schemas/LocationSchema"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","example":1500000.0},"agreed_monthly_premium_usd":{"type":"number","minimum":1.0,"title":"Agreed Monthly Premium Usd","example":585.45}},"type":"object","required":["quote_policy_id","location","tiv_usd","agreed_monthly_premium_usd"],"title":"PolicyBindRequest"},"PolicyBindResponse":{"properties":{"status":{"type":"string","title":"Status","default":"POLICY_BOUND_SUCCESS"},"policy_number":{"type":"string","title":"Policy Number"},"bound_status":{"type":"string","title":"Bound Status","default":"ACTIVE_BOUND"},"account_id":{"type":"string","title":"Account Id"},"hazard_domain":{"type":"string","title":"Hazard Domain"},"tiv_usd":{"type":"number","title":"Tiv Usd"},"pml_usd":{"type":"number","title":"Pml Usd"},"monthly_premium_usd":{"type":"number","title":"Monthly Premium Usd"},"effective_date_utc":{"type":"string","title":"Effective Date Utc"},"expiration_date_utc":{"type":"string","title":"Expiration Date Utc"},"spatial_pml_locked_in_radius_usd":{"type":"number","title":"Spatial Pml Locked In Radius Usd"},"producer_license_number":{"type":"string","title":"Producer License Number","default":"4501603"}},"type":"object","required":["policy_number","account_id","hazard_domain","tiv_usd","pml_usd","monthly_premium_usd","effective_date_utc","expiration_date_utc","spatial_pml_locked_in_radius_usd"],"title":"PolicyBindResponse"},"PolicyCancelRequest":{"properties":{"policy_number":{"type":"string","title":"Policy Number","example":"POL_WI_A1B2C3D4"},"cancellation_reason":{"type":"string","title":"Cancellation Reason","default":"CARRIER_REQUEST","example":"PROP_SOLD"}},"type":"object","required":["policy_number"],"title":"PolicyCancelRequest"},"PortfolioEvaluateBody":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":2000.0,"title":"Year","default":2026},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"Evaluation as-of YYYY-MM-DD (checks day-of freeze)"},"policies":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Policies","description":"List of policy records with policy_id, zip, tiv_usd, and optional base_rate"},"csv_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Csv Text","description":"Optional raw CSV text with zip and tiv_usd columns"},"prefer_seal":{"type":"boolean","title":"Prefer Seal","default":true}},"type":"object","title":"PortfolioEvaluateBody"},"PropertyRiskProfileRequest":{"properties":{"location":{"anyOf":[{"$ref":"#/components/schemas/LocationSchema"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","example":"1250 Silverado Trail, St. Helena, CA 94574"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code","example":"94574"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","default":10000000.0,"example":1500000.0},"distance_to_brush_ft":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Distance To Brush Ft","default":100.0,"example":100.0},"elevation_ft_above_base_flood":{"type":"number","maximum":200.0,"minimum":-50.0,"title":"Elevation Ft Above Base Flood","default":2.0,"example":2.5}},"type":"object","title":"PropertyRiskProfileRequest"},"PropertyRiskProfileResponse":{"properties":{"location":{"$ref":"#/components/schemas/LocationSchema"},"tiv_usd":{"type":"number","title":"Tiv Usd"},"composite_risk_score":{"type":"number","title":"Composite Risk Score"},"overall_bindable":{"type":"boolean","title":"Overall Bindable"},"domain_summaries":{"additionalProperties":{"$ref":"#/components/schemas/DomainRiskSummarySchema"},"type":"object","title":"Domain Summaries"},"pml_capacity_available_in_radius_usd":{"type":"number","title":"Pml Capacity Available In Radius Usd"},"producer_license_number":{"type":"string","title":"Producer License Number","default":"4501603"}},"type":"object","required":["location","tiv_usd","composite_risk_score","overall_bindable","domain_summaries","pml_capacity_available_in_radius_usd"],"title":"PropertyRiskProfileResponse"},"QuoteResponseSchema":{"properties":{"policy_id":{"type":"string","title":"Policy Id"},"status":{"type":"string","title":"Status"},"bound":{"type":"boolean","title":"Bound"},"tiv_usd":{"type":"number","title":"Tiv Usd"},"pml_usd":{"type":"number","title":"Pml Usd"},"base_monthly_premium_usd":{"type":"number","title":"Base Monthly Premium Usd"},"final_monthly_premium_usd":{"type":"number","title":"Final Monthly Premium Usd"},"dynamic_monthly_loading_usd":{"type":"number","title":"Dynamic Monthly Loading Usd"},"dynamic_loading_multiplier":{"type":"number","title":"Dynamic Loading Multiplier"},"applied_deductible_pct":{"type":"number","title":"Applied Deductible Pct"},"required_mitigation":{"type":"string","title":"Required Mitigation"},"kill_switch_triggered":{"type":"boolean","title":"Kill Switch Triggered"},"kill_switch_reasons":{"items":{"type":"string"},"type":"array","title":"Kill Switch Reasons"},"current_spatial_pml_in_radius_usd":{"type":"number","title":"Current Spatial Pml In Radius Usd"},"agent_flags":{"$ref":"#/components/schemas/AgentFlagsSchema"},"explainability":{"anyOf":[{"$ref":"#/components/schemas/ExplainabilityBreakdownSchema"},{"type":"null"}]},"billing_receipt":{"$ref":"#/components/schemas/BillingReceiptSchema"},"producer_license_number":{"type":"string","title":"Producer License Number","default":"4501603"},"location":{"anyOf":[{"$ref":"#/components/schemas/LocationSchema"},{"type":"null"}]},"resolved_location":{"anyOf":[{"$ref":"#/components/schemas/LocationSchema"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"spatial_hazard_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spatial Hazard Score"},"hazard_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hazard Score"},"formatted_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Formatted Address"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"match_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Quality"},"adverse_action_disclosure":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Adverse Action Disclosure"}},"type":"object","required":["policy_id","status","bound","tiv_usd","pml_usd","base_monthly_premium_usd","final_monthly_premium_usd","dynamic_monthly_loading_usd","dynamic_loading_multiplier","applied_deductible_pct","required_mitigation","kill_switch_triggered","kill_switch_reasons","current_spatial_pml_in_radius_usd","agent_flags","billing_receipt"],"title":"QuoteResponseSchema"},"SpatialBucketAggregate":{"properties":{"zip":{"type":"string","title":"Zip","description":"5-digit CA ZIP code or 3-digit prefix"},"total_tiv_usd":{"type":"number","minimum":0.0,"title":"Total Tiv Usd","description":"Aggregated TIV in USD for this ZIP"},"policy_count":{"type":"integer","minimum":1.0,"title":"Policy Count","description":"Number of anonymous policies in this bucket","default":1},"weighted_base_rate":{"type":"number","maximum":1.0,"minimum":0.0001,"title":"Weighted Base Rate","description":"Weighted average base rate","default":0.005}},"type":"object","required":["zip","total_tiv_usd"],"title":"SpatialBucketAggregate"},"StripePortalRequest":{"properties":{"return_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Url","default":"/app/billing","example":"/app/billing"}},"type":"object","title":"StripePortalRequest"},"TeamInviteRequest":{"properties":{"email":{"type":"string","maxLength":120,"minLength":5,"title":"Email","example":"underwriter@carrier.com"},"role":{"type":"string","title":"Role","default":"SENIOR_UNDERWRITER","example":"SENIOR_UNDERWRITER"},"full_name":{"anyOf":[{"type":"string","maxLength":80,"minLength":2},{"type":"null"}],"title":"Full Name","example":"Jane Actuary"}},"type":"object","required":["email"],"title":"TeamInviteRequest"},"TicketDetailResponse":{"properties":{"ticket_id":{"type":"string","title":"Ticket Id"},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"},"user_email":{"type":"string","title":"User Email"},"full_name":{"type":"string","title":"Full Name"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"category":{"type":"string","title":"Category"},"priority":{"type":"string","title":"Priority"},"subject":{"type":"string","title":"Subject"},"description":{"type":"string","title":"Description"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"messages":{"items":{"$ref":"#/components/schemas/MessageItem"},"type":"array","title":"Messages"}},"type":"object","required":["ticket_id","tenant_id","user_email","full_name","company_name","category","priority","subject","description","status","created_at","updated_at","messages"],"title":"TicketDetailResponse"},"UnifiedQuoteRequest":{"properties":{"hazard_domain":{"type":"string","title":"Hazard Domain","description":"wildfire or flood","default":"wildfire","example":"wildfire"},"policy_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":3},{"type":"null"}],"title":"Policy Id","example":"POL_WF_1001"},"location":{"anyOf":[{"$ref":"#/components/schemas/LocationSchema"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","example":"1250 Silverado Trail, St. Helena, CA 94574"},"zip_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Zip Code","example":"94574"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","default":10000000.0,"example":1500000.0},"distance_to_brush_ft":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Distance To Brush Ft","default":100.0,"example":100.0},"clearance_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Clearance Score","default":0.85,"example":0.85},"elevation_ft_above_base_flood":{"anyOf":[{"type":"number","maximum":200.0,"minimum":-50.0},{"type":"null"}],"title":"Elevation Ft Above Base Flood","default":2.0,"example":2.5}},"type":"object","title":"UnifiedQuoteRequest"},"UpdateProfileRequest":{"properties":{"dba_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dba Name","example":"Acme Underwriting"},"fein_tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fein Tax Id","example":"95-1234567"},"naic_company_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naic Company Code","example":"12345"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type","example":"MGA"},"nipr_producer_license_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nipr Producer License Number","example":"4501603"},"resident_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resident State","example":"CA"},"authorized_states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Authorized States","example":["CA","FL","TX","CO","NV"]},"primary_contact_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Contact Name","example":"Conner Kupferberg"},"primary_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Contact Email","example":"conner@twe-actuarial.com"},"billing_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Email","example":"billing@twe-actuarial.com"},"webhook_dispatch_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Dispatch Url","example":"https://carrier.com/webhooks"},"webhook_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Secret","example":"whsec_12345"}},"type":"object","title":"UpdateProfileRequest"},"UpdateTenantSettingsRequest":{"properties":{"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"dba_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dba Name"},"fein_tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fein Tax Id"},"naic_company_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naic Company Code"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"physical_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Physical Address"},"billing_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Email"},"tax_exempt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tax Exempt"},"nipr_producer_license_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nipr Producer License Number"},"resident_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resident State"},"authorized_states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Authorized States"},"surplus_lines_license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Surplus Lines License"},"primary_contact_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Contact Name"},"primary_contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Contact Email"},"e_and_o_carrier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"E And O Carrier"},"e_and_o_policy_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"E And O Policy Number"},"e_and_o_limit_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"E And O Limit Usd"},"e_and_o_expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"E And O Expiration Date"},"max_single_risk_tiv_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Single Risk Tiv Usd"},"radial_solvency_pml_cap_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Radial Solvency Pml Cap Usd"},"cuo_referral_hazard_threshold":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cuo Referral Hazard Threshold"},"auto_bind_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Bind Enabled"},"cdi_discount_enforced":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cdi Discount Enforced"},"default_deductible_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Default Deductible Pct"},"convective_quiet_hours_requirement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Convective Quiet Hours Requirement"},"webhook_dispatch_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Dispatch Url"},"webhook_secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Secret"},"auto_recharge_threshold_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Auto Recharge Threshold Usd"},"auto_recharge_amount_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Auto Recharge Amount Usd"}},"type":"object","title":"UpdateTenantSettingsRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WildfireQuoteRequest":{"properties":{"policy_id":{"type":"string","maxLength":64,"minLength":3,"title":"Policy Id","example":"POL_WF_1001"},"location":{"$ref":"#/components/schemas/LocationSchema"},"tiv_usd":{"type":"number","maximum":500000000.0,"minimum":10000.0,"title":"Tiv Usd","example":1500000.0},"distance_to_brush_ft":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Distance To Brush Ft","default":100.0,"example":100.0},"clearance_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Clearance Score","default":0.85,"example":0.85},"zone_compliant":{"type":"boolean","title":"Zone Compliant","default":true,"example":true},"base_annual_rate":{"type":"number","maximum":0.2,"minimum":0.0001,"title":"Base Annual Rate","default":0.005,"example":0.005},"z_dryness_30d":{"type":"number","maximum":10.0,"minimum":-5.0,"title":"Z Dryness 30D","default":1.0,"example":1.5},"era5_gust_u_m_s":{"type":"number","maximum":150.0,"minimum":-150.0,"title":"Era5 Gust U M S","default":10.0,"example":12.0},"era5_gust_v_m_s":{"type":"number","maximum":150.0,"minimum":-150.0,"title":"Era5 Gust V M S","default":10.0,"example":12.0}},"type":"object","required":["policy_id","location","tiv_usd"],"title":"WildfireQuoteRequest"},"ZeroKnowledgeEvaluateBody":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":2000.0,"title":"Year","default":2026},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","description":"Evaluation date YYYY-MM-DD (checks day-of freeze)"},"aggregates":{"items":{"$ref":"#/components/schemas/SpatialBucketAggregate"},"type":"array","minItems":1,"title":"Aggregates","description":"List of anonymous spatial bucket aggregates"}},"type":"object","required":["aggregates"],"title":"ZeroKnowledgeEvaluateBody"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}