{"openapi":"3.1.0","info":{"title":"IncorpSignal API","description":"Companies House API with AI-assisted search and live UK company intelligence. Session cookie auth for the web app; `X-API-Key` for Scout Plus programmatic access. Search supports structured operators and natural-language phrases parsed to DSL via `/nl/search/*` and `/v1/nl/parse`. For AI agents, use 26 MCP tools or explicit x402 pay-per-call routes. Interactive docs at `/docs`.","version":"1.0.0"},"servers":[{"url":"https://incorpsignal.com/api","description":"Current environment"}],"paths":{"/health":{"get":{"tags":["health"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Health Health Get"}}}}}}},"/ready":{"get":{"tags":["health"],"summary":"Ready","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"type":"object","title":"Response Ready Ready Get"}}}}}}},"/public/companies/{company_number}/preview":{"get":{"tags":["public-seo"],"summary":"Company Public Preview","operationId":"company_public_preview_public_companies__company_number__preview_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyPublicPreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/companies/{company_number}/page":{"get":{"tags":["public-seo"],"summary":"Company Public Page Html","operationId":"company_public_page_html_public_companies__company_number__page_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/sic/{code}":{"get":{"tags":["public-seo"],"summary":"Sic Public","operationId":"sic_public_public_sic__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SicPublicPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/sic/{code}/page":{"get":{"tags":["public-seo"],"summary":"Sic Public Page Html","operationId":"sic_public_page_html_public_sic__code__page_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/signals/{slug}":{"get":{"tags":["public-seo"],"summary":"Signal Landing Json","operationId":"signal_landing_json_public_signals__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalLandingPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/signals/{slug}/page":{"get":{"tags":["public-seo"],"summary":"Signal Landing Html","operationId":"signal_landing_html_public_signals__slug__page_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/new-companies":{"get":{"tags":["public-seo"],"summary":"New Companies Public","operationId":"new_companies_public_public_new_companies_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}},{"name":"sic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{5}$"},{"type":"null"}],"title":"Sic"}},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Region"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCompaniesPublicResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/semantic-search/companies":{"get":{"tags":["public-seo"],"summary":"Semantic Search Companies Public","operationId":"semantic_search_companies_public_public_semantic_search_companies_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":240,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemanticSearchPublicResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/recommendations/search":{"get":{"tags":["public-seo"],"summary":"Search Recommendations Public","operationId":"search_recommendations_public_public_recommendations_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":240,"default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"default":8,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRecommendationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/stats/weekly-incorporations":{"get":{"tags":["public-seo"],"summary":"Weekly Incorporations Stats","operationId":"weekly_incorporations_stats_public_stats_weekly_incorporations_get","parameters":[{"name":"weeks","in":"query","required":false,"schema":{"type":"integer","maximum":52,"minimum":1,"default":12,"title":"Weeks"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Weekly Incorporations Stats Public Stats Weekly Incorporations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/stats/hot-sectors":{"get":{"tags":["public-seo"],"summary":"Hot Sectors Stats","operationId":"hot_sectors_stats_public_stats_hot_sectors_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":7,"default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Hot Sectors Stats Public Stats Hot Sectors Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/research/weekly-snapshot/page":{"get":{"tags":["public-seo"],"summary":"Research Weekly Snapshot Html","operationId":"research_weekly_snapshot_html_public_research_weekly_snapshot_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/search/recommendations/page":{"get":{"tags":["public-seo"],"summary":"Search Recommendations Html","operationId":"search_recommendations_html_public_search_recommendations_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/developers/page":{"get":{"tags":["public-seo"],"summary":"Developers Public Page Html","operationId":"developers_public_page_html_public_developers_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/home/page":{"get":{"tags":["public-seo"],"summary":"Home Public Page Html","operationId":"home_public_page_html_public_home_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/features/page":{"get":{"tags":["public-seo"],"summary":"Features Public Page Html","operationId":"features_public_page_html_public_features_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/pricing/page":{"get":{"tags":["public-seo"],"summary":"Pricing Public Page Html","operationId":"pricing_public_page_html_public_pricing_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/trends/page":{"get":{"tags":["public-seo"],"summary":"Trends Public Page Html","operationId":"trends_public_page_html_public_trends_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/companies-house-ai-search/page":{"get":{"tags":["public-seo"],"summary":"Companies House Ai Search Html","operationId":"companies_house_ai_search_html_public_companies_house_ai_search_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/public/use-cases/{slug}/page":{"get":{"tags":["public-seo"],"summary":"Use Case Html","operationId":"use_case_html_public_use_cases__slug__page_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/legal/config":{"get":{"tags":["legal"],"summary":"Legal Config","operationId":"legal_config_legal_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalConfig"}}}}}}},"/metrics/events":{"post":{"tags":["metrics"],"summary":"Record Client Event","operationId":"record_client_event_metrics_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricsEventIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Record Client Event Metrics Events Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/status":{"get":{"tags":["admin"],"summary":"Admin Status","operationId":"admin_status_admin_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminStatus"}}}}}}},"/admin/metrics":{"get":{"tags":["admin"],"summary":"Admin Metrics","operationId":"admin_metrics_admin_metrics_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMetricsSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users":{"get":{"tags":["admin"],"summary":"Admin Users","operationId":"admin_users_admin_users_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserRow"},"title":"Response Admin Users Admin Users Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orgs":{"get":{"tags":["admin"],"summary":"Admin Orgs","operationId":"admin_orgs_admin_orgs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminOrgRow"},"title":"Response Admin Orgs Admin Orgs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/subscriptions":{"get":{"tags":["admin"],"summary":"Admin Subscriptions","operationId":"admin_subscriptions_admin_subscriptions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSubscriptionRow"},"title":"Response Admin Subscriptions Admin Subscriptions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/subscriptions/{org_id}":{"patch":{"tags":["admin"],"summary":"Admin Update Subscription","operationId":"admin_update_subscription_admin_subscriptions__org_id__patch","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSubscriptionUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSubscriptionRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/methods":{"get":{"tags":["auth"],"summary":"Methods","operationId":"methods_auth_methods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthMethods"}}}}}}},"/auth/signup":{"post":{"tags":["auth"],"summary":"Signup","operationId":"signup_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSession"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/login":{"post":{"tags":["auth"],"summary":"Login","operationId":"login_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSession"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/google/dev-login":{"post":{"tags":["auth"],"summary":"Google Dev Login","operationId":"google_dev_login_auth_google_dev_login_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSession"}}}}}}},"/auth/google/login":{"get":{"tags":["auth"],"summary":"Google Login","operationId":"google_login_auth_google_login_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/google/callback":{"get":{"tags":["auth"],"summary":"Google Callback","operationId":"google_callback_auth_google_callback_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","operationId":"logout_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Logout Auth Logout Post"}}}}}}},"/auth/me":{"get":{"tags":["auth"],"summary":"Me","operationId":"me_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UserSession"},{"type":"null"}],"title":"Response Me Auth Me Get"}}}}}}},"/auth/account":{"get":{"tags":["auth"],"summary":"Account","operationId":"account_auth_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}}}},"patch":{"tags":["auth"],"summary":"Update Account","operationId":"update_account_auth_account_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/account/password":{"post":{"tags":["auth"],"summary":"Change Password","operationId":"change_password_auth_account_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordChangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/email-status":{"get":{"tags":["auth"],"summary":"Email Status","operationId":"email_status_auth_email_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Response Email Status Auth Email Status Get"}}}}}}},"/auth/password/forgot":{"post":{"tags":["auth"],"summary":"Forgot Password","operationId":"forgot_password_auth_password_forgot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Forgot Password Auth Password Forgot Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/password/reset":{"post":{"tags":["auth"],"summary":"Reset Password","operationId":"reset_password_auth_password_reset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboard":{"get":{"tags":["companies"],"summary":"Dashboard","operationId":"dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardPayload"}}}}}}},"/live-feed":{"get":{"tags":["companies"],"summary":"Live Feed","operationId":"live_feed_live_feed_get","parameters":[{"name":"resource","in":"query","required":false,"schema":{"type":"string","default":"companies","title":"Resource"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LiveFeedEvent"},"title":"Response Live Feed Live Feed Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stream/access":{"get":{"tags":["companies"],"summary":"Stream Access","operationId":"stream_access_stream_access_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stream Access Stream Access Get"}}}}}}},"/hotspots":{"get":{"tags":["companies"],"summary":"Hotspot Preview","operationId":"hotspot_preview_hotspots_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":120,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HotspotFeature"},"title":"Response Hotspot Preview Hotspots Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/search":{"get":{"tags":["companies"],"summary":"Search Companies","description":"Search Companies House with structured operators or a direct text query.\n\nFor natural-language phrases (e.g. \"AI companies in London with repeat founders\"),\nparse with POST /nl/search/parse first, then POST /companies/search with the returned DSL.","operationId":"search_companies_companies_search_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Structured query: company number, name, sic:, person:, or plain text","title":"Query"},"description":"Structured query: company number, name, sic:, person:, or plain text"},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["companies"],"summary":"Search Companies With Dsl","description":"Execute a precision Companies House search from a validated SearchDsl.\n\nThe web app and API clients typically obtain the DSL from POST /nl/search/parse\n(natural language) or build it manually for sector, location, SIC, compliance, and founder filters.","operationId":"search_companies_with_dsl_companies_search_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDsl"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}":{"get":{"tags":["companies"],"summary":"Company Detail","operationId":"company_detail_companies__company_number__get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}/similar":{"get":{"tags":["companies"],"summary":"Similar Companies","operationId":"similar_companies_companies__company_number__similar_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyMatch"},"title":"Response Similar Companies Companies  Company Number  Similar Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/officers/{officer_id}/intelligence":{"get":{"tags":["companies"],"summary":"Officer Intelligence","operationId":"officer_intelligence_officers__officer_id__intelligence_get","parameters":[{"name":"officer_id","in":"path","required":true,"schema":{"type":"string","title":"Officer Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":250,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficerIntelligence"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}/documents/{transaction_id}/metadata":{"get":{"tags":["companies"],"summary":"Filing Document Metadata","operationId":"filing_document_metadata_companies__company_number__documents__transaction_id__metadata_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Filing Document Metadata Companies  Company Number  Documents  Transaction Id  Metadata Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}/documents/{transaction_id}/download":{"get":{"tags":["companies"],"summary":"Download Company Document","operationId":"download_company_document_companies__company_number__documents__transaction_id__download_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}/compliance":{"get":{"tags":["compliance"],"summary":"Company Compliance","operationId":"company_compliance_companies__company_number__compliance_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyComplianceReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/compliance/report":{"post":{"tags":["compliance"],"summary":"Compliance Batch Report","operationId":"compliance_batch_report_compliance_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_number}/documents/{transaction_id}/summarize":{"post":{"tags":["compliance"],"summary":"Summarize Filing Document","operationId":"summarize_filing_document_companies__company_number__documents__transaction_id__summarize_post","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/e2e/subscription":{"post":{"tags":["e2e"],"summary":"E2E Grant Subscription","operationId":"e2e_grant_subscription_e2e_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/E2eSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response E2E Grant Subscription E2E Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/e2e/usage/reset":{"post":{"tags":["e2e"],"summary":"E2E Reset Usage","operationId":"e2e_reset_usage_e2e_usage_reset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/E2eUsageResetRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response E2E Reset Usage E2E Usage Reset Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/nl/search/parse":{"post":{"tags":["alerts"],"summary":"Parse Search","description":"Parse a natural-language Companies House search phrase into structured SearchDsl.\n\nUses deterministic heuristics by default; may call OpenAI structured parsing when enabled.\nRejects non-search chatbot prompts. Example: \"software companies in Bristol still trading with accounts due\".","operationId":"parse_search_nl_search_parse_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDsl"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/nl/search/status":{"get":{"tags":["alerts"],"summary":"Nl Search Status","description":"Report natural-language search parser configuration and optional OpenAI provider health.","operationId":"nl_search_status_nl_search_status_get","parameters":[{"name":"check_provider","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Check Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"string"},{"type":"number"},{"type":"null"}]},"title":"Response Nl Search Status Nl Search Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alerts":{"get":{"tags":["alerts"],"summary":"List Alerts","operationId":"list_alerts_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AlertRule"},"type":"array","title":"Response List Alerts Alerts Get"}}}}}},"post":{"tags":["alerts"],"summary":"Create Alert","operationId":"create_alert_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alerts/{alert_id}":{"get":{"tags":["alerts"],"summary":"Get Alert","operationId":"get_alert_alerts__alert_id__get","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["alerts"],"summary":"Patch Alert","operationId":"patch_alert_alerts__alert_id__patch","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["alerts"],"summary":"Delete Alert","operationId":"delete_alert_alerts__alert_id__delete","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Delete Alert Alerts  Alert Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alert-matches":{"get":{"tags":["alerts"],"summary":"Alert Matches","operationId":"alert_matches_alert_matches_get","parameters":[{"name":"alert_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alert Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AlertMatch"},"title":"Response Alert Matches Alert Matches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alerts/deliver":{"post":{"tags":["alerts"],"summary":"Deliver Alert Matches","operationId":"deliver_alert_matches_alerts_deliver_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Deliver Alert Matches Alerts Deliver Post"}}}}}}},"/notifications/test":{"post":{"tags":["alerts"],"summary":"Test Notification","operationId":"test_notification_notifications_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/watchlist":{"get":{"tags":["watchlist"],"summary":"List Watchlist","operationId":"list_watchlist_watchlist_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistListResponse"}}}}}},"post":{"tags":["watchlist"],"summary":"Add Watchlist Entry","operationId":"add_watchlist_entry_watchlist_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistEntry"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/watchlist/{company_number}":{"delete":{"tags":["watchlist"],"summary":"Remove Watchlist Entry","operationId":"remove_watchlist_entry_watchlist__company_number__delete","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Remove Watchlist Entry Watchlist  Company Number  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trends":{"get":{"tags":["trends"],"summary":"Trends","operationId":"trends_trends_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendsResponse"}}}}}}},"/trends/hotspots":{"get":{"tags":["trends"],"summary":"Trend Hotspots","operationId":"trend_hotspots_trends_hotspots_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":14,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HotspotFeature"},"title":"Response Trend Hotspots Trends Hotspots Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clusters":{"get":{"tags":["trends"],"summary":"Clusters","operationId":"clusters_clusters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Clusters Clusters Get"}}}}}}},"/rankings/profiles":{"get":{"tags":["rankings"],"summary":"Ranking Profiles","operationId":"ranking_profiles_rankings_profiles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ranking Profiles Rankings Profiles Get"}}}}}}},"/rankings/recompute":{"post":{"tags":["rankings"],"summary":"Recompute Rankings","operationId":"recompute_rankings_rankings_recompute_post","parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}},{"name":"company_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Number"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":250,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recompute Rankings Rankings Recompute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/plans":{"get":{"tags":["billing"],"summary":"Billing Plans","operationId":"billing_plans_billing_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Plans Billing Plans Get"}}}}}}},"/billing/checkout-session":{"post":{"tags":["billing"],"summary":"Checkout Session","operationId":"checkout_session_billing_checkout_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/usage":{"get":{"tags":["billing"],"summary":"Billing Usage","operationId":"billing_usage_billing_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Billing Usage Billing Usage Get"}}}}}}},"/billing/portal-session":{"post":{"tags":["billing"],"summary":"Portal Session","operationId":"portal_session_billing_portal_session_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSessionResponse"}}}}}}},"/billing/subscription":{"get":{"tags":["billing"],"summary":"Subscription","operationId":"subscription_billing_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionState"}}}}}}},"/webhooks/resend":{"post":{"tags":["billing"],"summary":"Resend Webhook","operationId":"resend_webhook_webhooks_resend_post","parameters":[{"name":"svix-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Svix-Id"}},{"name":"svix-timestamp","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Svix-Timestamp"}},{"name":"svix-signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Svix-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"title":"Response Resend Webhook Webhooks Resend Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/stripe":{"post":{"tags":["billing"],"summary":"Stripe Webhook","operationId":"stripe_webhook_webhooks_stripe_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":{"type":"object","additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"title":"Response Stripe Webhook Webhooks Stripe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys":{"get":{"tags":["api-keys"],"summary":"List Api Keys","operationId":"list_api_keys_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyList"}}}}}},"post":{"tags":["api-keys"],"summary":"Create Api Key","operationId":"create_api_key_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys/{key_id}/rotate":{"post":{"tags":["api-keys"],"summary":"Rotate Api Key","operationId":"rotate_api_key_api_keys__key_id__rotate_post","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/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys/{key_id}":{"delete":{"tags":["api-keys"],"summary":"Revoke Api Key","operationId":"revoke_api_key_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Revoke Api Key Api Keys  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent-tokens":{"get":{"tags":["agent-tokens"],"summary":"List Agent Tokens","operationId":"list_agent_tokens_agent_tokens_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyList"}}}}}},"post":{"tags":["agent-tokens"],"summary":"Create Agent Token","operationId":"create_agent_token_agent_tokens_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent-tokens/{key_id}/rotate":{"post":{"tags":["agent-tokens"],"summary":"Rotate Agent Token","operationId":"rotate_agent_token_agent_tokens__key_id__rotate_post","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/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agent-tokens/{key_id}":{"delete":{"tags":["agent-tokens"],"summary":"Revoke Agent Token","operationId":"revoke_agent_token_agent_tokens__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Revoke Agent Token Agent Tokens  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/plans":{"get":{"tags":["v1-api"],"summary":"V1 Plans","operationId":"v1_plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Plans V1 Plans Get"}}}}}}},"/v1/usage":{"get":{"tags":["v1-api"],"summary":"V1 Usage","operationId":"v1_usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Usage V1 Usage Get"}}}}}}},"/v1/search":{"get":{"tags":["v1-api"],"summary":"V1 Search","description":"Search Companies House. For natural language, call POST /v1/nl/parse then POST /v1/search with the DSL.","operationId":"v1_search_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Structured or plain-text Companies House query","title":"Q"},"description":"Structured or plain-text Companies House query"},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["v1-api"],"summary":"V1 Search Dsl","description":"Execute a SearchDsl precision search (from POST /v1/nl/parse or manual construction).","operationId":"v1_search_dsl_v1_search_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDsl"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/nl/parse":{"post":{"tags":["v1-api"],"summary":"V1 Nl Parse","description":"Parse natural-language search into SearchDsl (heuristic + optional OpenAI). Same rules as POST /nl/search/parse.","operationId":"v1_nl_parse_v1_nl_parse_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDsl"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard":{"get":{"tags":["v1-api"],"summary":"V1 Dashboard","operationId":"v1_dashboard_v1_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardPayload"}}}}}}},"/v1/companies/{company_number}":{"get":{"tags":["v1-api"],"summary":"V1 Company","operationId":"v1_company_v1_companies__company_number__get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{company_number}/enrichment":{"get":{"tags":["v1-api"],"summary":"V1 Company Enrichment","operationId":"v1_company_enrichment_v1_companies__company_number__enrichment_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Company Enrichment V1 Companies  Company Number  Enrichment Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/officers/{officer_id}/intelligence":{"get":{"tags":["v1-api"],"summary":"V1 Officer Intelligence","operationId":"v1_officer_intelligence_v1_officers__officer_id__intelligence_get","parameters":[{"name":"officer_id","in":"path","required":true,"schema":{"type":"string","title":"Officer Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":250,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficerIntelligence"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{company_number}/documents/{transaction_id}/metadata":{"get":{"tags":["v1-api"],"summary":"V1 Filing Metadata","operationId":"v1_filing_metadata_v1_companies__company_number__documents__transaction_id__metadata_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Filing Metadata V1 Companies  Company Number  Documents  Transaction Id  Metadata Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{company_number}/documents/{transaction_id}/download":{"get":{"tags":["v1-api"],"summary":"V1 Filing Download","operationId":"v1_filing_download_v1_companies__company_number__documents__transaction_id__download_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trends":{"get":{"tags":["v1-api"],"summary":"V1 Trends","operationId":"v1_trends_v1_trends_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendsResponse"}}}}}}},"/v1/trends/hotspots":{"get":{"tags":["v1-api"],"summary":"V1 Trend Hotspots","operationId":"v1_trend_hotspots_v1_trends_hotspots_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":14,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HotspotFeature"},"title":"Response V1 Trend Hotspots V1 Trends Hotspots Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/hotspots":{"get":{"tags":["v1-api"],"summary":"V1 Hotspots","operationId":"v1_hotspots_v1_hotspots_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":120,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HotspotFeature"},"title":"Response V1 Hotspots V1 Hotspots Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/clusters":{"get":{"tags":["v1-api"],"summary":"V1 Clusters","operationId":"v1_clusters_v1_clusters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Clusters V1 Clusters Get"}}}}}}},"/v1/rankings/profiles":{"get":{"tags":["v1-api"],"summary":"V1 Ranking Profiles","operationId":"v1_ranking_profiles_v1_rankings_profiles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Ranking Profiles V1 Rankings Profiles Get"}}}}}}},"/v1/live-feed":{"get":{"tags":["v1-api"],"summary":"V1 Live Feed","operationId":"v1_live_feed_v1_live_feed_get","parameters":[{"name":"resource","in":"query","required":false,"schema":{"type":"string","default":"companies","title":"Resource"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LiveFeedEvent"},"title":"Response V1 Live Feed V1 Live Feed Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stream/access":{"get":{"tags":["v1-api"],"summary":"V1 Stream Access","operationId":"v1_stream_access_v1_stream_access_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Stream Access V1 Stream Access Get"}}}}}}},"/v1/alerts":{"get":{"tags":["v1-api"],"summary":"V1 List Alerts","operationId":"v1_list_alerts_v1_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AlertRule"},"type":"array","title":"Response V1 List Alerts V1 Alerts Get"}}}}}},"post":{"tags":["v1-api"],"summary":"V1 Create Alert","operationId":"v1_create_alert_v1_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alerts/{alert_id}":{"get":{"tags":["v1-api"],"summary":"V1 Get Alert","operationId":"v1_get_alert_v1_alerts__alert_id__get","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["v1-api"],"summary":"V1 Patch Alert","operationId":"v1_patch_alert_v1_alerts__alert_id__patch","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRule"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["v1-api"],"summary":"V1 Delete Alert","operationId":"v1_delete_alert_v1_alerts__alert_id__delete","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response V1 Delete Alert V1 Alerts  Alert Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alert-matches":{"get":{"tags":["v1-api"],"summary":"V1 Alert Matches","operationId":"v1_alert_matches_v1_alert_matches_get","parameters":[{"name":"alert_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by alert rule ID","title":"Alert Id"},"description":"Filter by alert rule ID"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by match status (open, delivered, etc.)","title":"Status"},"description":"Filter by match status (open, delivered, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AlertMatch"},"title":"Response V1 Alert Matches V1 Alert Matches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/alerts/deliver":{"post":{"tags":["v1-api"],"summary":"V1 Deliver Alerts","operationId":"v1_deliver_alerts_v1_alerts_deliver_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response V1 Deliver Alerts V1 Alerts Deliver Post"}}}}}}},"/v1/companies/{company_number}/compliance":{"get":{"tags":["v1-api"],"summary":"V1 Company Compliance","operationId":"v1_company_compliance_v1_companies__company_number__compliance_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyComplianceReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compliance/report":{"post":{"tags":["v1-api"],"summary":"V1 Compliance Batch Report","operationId":"v1_compliance_batch_report_v1_compliance_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{company_number}/documents/{transaction_id}/summarize":{"post":{"tags":["v1-api"],"summary":"V1 Summarize Filing Document","operationId":"v1_summarize_filing_document_v1_companies__company_number__documents__transaction_id__summarize_post","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"transaction_id","in":"path","required":true,"schema":{"type":"string","title":"Transaction Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/v1/catalog":{"get":{"tags":["x402"],"summary":"X402 Catalog","description":"Machine-readable pay-per-call products for wallets and AI agents.","operationId":"x402_catalog_x402_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response X402 Catalog X402 V1 Catalog Get"}}}}}}},"/x402/v1/search":{"get":{"tags":["x402"],"summary":"X402 Search","operationId":"x402_search_x402_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Q"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/v1/companies/{company_number}":{"get":{"tags":["x402"],"summary":"X402 Company","operationId":"x402_company_x402_v1_companies__company_number__get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","default":"investor","title":"Profile"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/v1/companies/{company_number}/signals":{"get":{"tags":["x402"],"summary":"X402 Company Signals","operationId":"x402_company_signals_x402_v1_companies__company_number__signals_get","parameters":[{"name":"company_number","in":"path","required":true,"schema":{"type":"string","title":"Company Number"}},{"name":"profile","in":"query","required":false,"schema":{"enum":["investor","recruiting","advertising","sales"],"type":"string","default":"investor","title":"Profile"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response X402 Company Signals X402 V1 Companies  Company Number  Signals Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/v1/incorporations":{"get":{"tags":["x402"],"summary":"X402 Incorporations","operationId":"x402_incorporations_x402_v1_incorporations_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":7,"title":"Days"}},{"name":"profile","in":"query","required":false,"schema":{"enum":["investor","recruiting","advertising","sales"],"type":"string","default":"investor","title":"Profile"}},{"name":"min_score","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":0,"default":70,"title":"Min Score"}},{"name":"sic_prefix","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":5,"pattern":"^\\d{2,5}$"},{"type":"null"}],"title":"Sic Prefix"}},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":80},{"type":"null"}],"title":"Region"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response X402 Incorporations X402 V1 Incorporations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/v1/trends":{"get":{"tags":["x402"],"summary":"X402 Trends","operationId":"x402_trends_x402_v1_trends_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response X402 Trends X402 V1 Trends Get"}}}}}}}},"components":{"schemas":{"AccountResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"org_id":{"type":"string","title":"Org Id"},"email":{"type":"string","format":"email","title":"Email"},"name":{"type":"string","title":"Name"},"auth_provider":{"type":"string","title":"Auth Provider"},"org_name":{"type":"string","title":"Org Name"},"entitlements":{"items":{"type":"string"},"type":"array","title":"Entitlements"},"has_password":{"type":"boolean","title":"Has Password","default":false}},"type":"object","required":["user_id","org_id","email","name","auth_provider","org_name","entitlements"],"title":"AccountResponse"},"AccountUpdateRequest":{"properties":{"name":{"type":"string","title":"Name","default":""},"org_name":{"type":"string","title":"Org Name","default":""},"email":{"type":"string","title":"Email","default":""}},"type":"object","title":"AccountUpdateRequest"},"AccountsCompliance":{"properties":{"accounting_reference_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Reference Date"},"last_period_end_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Period End On"},"last_made_up_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Made Up To"},"last_accounts_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Accounts Type"},"next_due_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Due On"},"next_period_end_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Period End On"},"overdue":{"type":"boolean","title":"Overdue","default":false},"status":{"$ref":"#/components/schemas/FilingStatus","default":"unknown"},"days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Until Due"}},"type":"object","title":"AccountsCompliance"},"ActionQueueItem":{"properties":{"audience":{"type":"string","title":"Audience"},"title":{"type":"string","title":"Title"},"count":{"type":"integer","title":"Count"},"action":{"type":"string","title":"Action"},"query_hint":{"type":"string","title":"Query Hint"},"top_companies":{"items":{"$ref":"#/components/schemas/TrendCompany"},"type":"array","title":"Top Companies"}},"type":"object","required":["audience","title","count","action","query_hint"],"title":"ActionQueueItem"},"ActiveUserRow":{"properties":{"org_id":{"type":"string","title":"Org Id"},"email":{"type":"string","title":"Email","default":""},"event_count":{"type":"integer","title":"Event Count"},"last_seen":{"type":"string","title":"Last Seen","default":""}},"type":"object","required":["org_id","event_count"],"title":"ActiveUserRow"},"AdminMetricsSummary":{"properties":{"window_days":{"type":"integer","title":"Window Days"},"total_events":{"type":"integer","title":"Total Events"},"searches":{"type":"integer","title":"Searches"},"signups":{"type":"integer","title":"Signups"},"logins":{"type":"integer","title":"Logins"},"company_views":{"type":"integer","title":"Company Views"},"unique_orgs":{"type":"integer","title":"Unique Orgs"},"top_searches":{"items":{"$ref":"#/components/schemas/TopSearchRow"},"type":"array","title":"Top Searches"},"events_by_type":{"items":{"$ref":"#/components/schemas/EventCountRow"},"type":"array","title":"Events By Type"},"active_users":{"items":{"$ref":"#/components/schemas/ActiveUserRow"},"type":"array","title":"Active Users"},"posthog_enabled":{"type":"boolean","title":"Posthog Enabled"}},"type":"object","required":["window_days","total_events","searches","signups","logins","company_views","unique_orgs","top_searches","events_by_type","active_users","posthog_enabled"],"title":"AdminMetricsSummary"},"AdminOrgRow":{"properties":{"org_id":{"type":"string","title":"Org Id"},"name":{"type":"string","title":"Name","default":""},"created_at":{"type":"string","title":"Created At","default":""}},"type":"object","required":["org_id"],"title":"AdminOrgRow"},"AdminStatus":{"properties":{"admin":{"type":"boolean","title":"Admin","default":true},"app_env":{"type":"string","title":"App Env"},"stripe_mode":{"type":"string","title":"Stripe Mode"},"require_auth":{"type":"boolean","title":"Require Auth"},"grant_preview_entitlements":{"type":"boolean","title":"Grant Preview Entitlements"}},"type":"object","required":["app_env","stripe_mode","require_auth","grant_preview_entitlements"],"title":"AdminStatus"},"AdminSubscriptionRow":{"properties":{"org_id":{"type":"string","title":"Org Id"},"tier":{"type":"string","title":"Tier","default":"free"},"status":{"type":"string","title":"Status","default":"inactive"},"stripe_customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Customer Id"},"stripe_subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Subscription Id"},"entitlements":{"items":{"type":"string"},"type":"array","title":"Entitlements"},"updated_at":{"type":"string","title":"Updated At","default":""}},"type":"object","required":["org_id"],"title":"AdminSubscriptionRow"},"AdminSubscriptionUpdate":{"properties":{"tier":{"type":"string","title":"Tier"},"status":{"type":"string","title":"Status","default":"active"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["tier"],"title":"AdminSubscriptionUpdate"},"AdminUserRow":{"properties":{"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name","default":""},"org_id":{"type":"string","title":"Org Id","default":""},"created_at":{"type":"string","title":"Created At","default":""}},"type":"object","required":["email"],"title":"AdminUserRow"},"AlertCreate":{"properties":{"name":{"type":"string","title":"Name"},"dsl":{"$ref":"#/components/schemas/SearchDsl"},"delivery_channels":{"items":{"type":"string"},"type":"array","title":"Delivery Channels","default":["in_app"]},"email_recipients":{"items":{"type":"string"},"type":"array","maxItems":1,"title":"Email Recipients"}},"type":"object","required":["name","dsl"],"title":"AlertCreate"},"AlertMatch":{"properties":{"id":{"type":"string","title":"Id"},"alert_id":{"type":"string","title":"Alert Id"},"company_number":{"type":"string","title":"Company Number"},"matched_at":{"type":"string","format":"date-time","title":"Matched At"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"score":{"type":"integer","title":"Score"},"status":{"type":"string","title":"Status","default":"open"},"delivery_state":{"type":"string","title":"Delivery State","default":"pending"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["id","alert_id","company_number","matched_at","reasons","score"],"title":"AlertMatch"},"AlertPatch":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"dsl":{"anyOf":[{"$ref":"#/components/schemas/SearchDsl"},{"type":"null"}]},"delivery_channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Delivery Channels"},"email_recipients":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1},{"type":"null"}],"title":"Email Recipients"}},"type":"object","title":"AlertPatch"},"AlertRule":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"name":{"type":"string","title":"Name"},"enabled":{"type":"boolean","title":"Enabled","default":true},"dsl":{"$ref":"#/components/schemas/SearchDsl"},"delivery_channels":{"items":{"type":"string"},"type":"array","title":"Delivery Channels","default":["in_app"]},"email_recipients":{"items":{"type":"string"},"type":"array","maxItems":1,"title":"Email Recipients"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","org_id","name","dsl","created_at","updated_at"],"title":"AlertRule"},"ApiKeyCreate":{"properties":{"name":{"type":"string","maxLength":80,"title":"Name","default":"Default"}},"type":"object","title":"ApiKeyCreate"},"ApiKeyCreated":{"properties":{"key_id":{"type":"string","title":"Key Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"secret":{"type":"string","title":"Secret"},"created_at":{"type":"string","title":"Created At","default":""},"message":{"type":"string","title":"Message","default":"Store this key securely — it is shown only once."}},"type":"object","required":["key_id","name","prefix","secret"],"title":"ApiKeyCreated"},"ApiKeyList":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/ApiKeyRow"},"type":"array","title":"Keys"}},"type":"object","required":["keys"],"title":"ApiKeyList"},"ApiKeyRow":{"properties":{"key_id":{"type":"string","title":"Key Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"created_at":{"type":"string","title":"Created At","default":""},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["key_id","name","prefix"],"title":"ApiKeyRow"},"AuthMethods":{"properties":{"email_password":{"type":"boolean","title":"Email Password","default":true},"google_configured":{"type":"boolean","title":"Google Configured","default":false},"google_dev_fallback":{"type":"boolean","title":"Google Dev Fallback","default":false},"google_login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Login Url"},"google_redirect_uris":{"items":{"type":"string"},"type":"array","title":"Google Redirect Uris","default":[]}},"type":"object","title":"AuthMethods"},"BillingSessionResponse":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"BillingSessionResponse"},"CheckoutRequest":{"properties":{"price_id":{"type":"string","title":"Price Id","default":"scout"},"org_id":{"type":"string","title":"Org Id","default":""}},"type":"object","title":"CheckoutRequest"},"CompanyComplianceReport":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"jurisdiction":{"type":"string","const":"UK","title":"Jurisdiction","default":"UK"},"accounts":{"$ref":"#/components/schemas/AccountsCompliance"},"confirmation":{"$ref":"#/components/schemas/ConfirmationCompliance"},"filings":{"items":{"$ref":"#/components/schemas/ComplianceFilingRecord"},"type":"array","title":"Filings"},"generated_at":{"type":"string","title":"Generated At"},"source":{"type":"string","const":"companies_house","title":"Source","default":"companies_house"}},"type":"object","required":["company_number","company_name","accounts","confirmation","generated_at"],"title":"CompanyComplianceReport"},"CompanyDetail":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"incorporated_on":{"type":"string","title":"Incorporated On"},"age_label":{"type":"string","title":"Age Label"},"location":{"type":"string","title":"Location"},"postcode":{"type":"string","title":"Postcode"},"signals":{"items":{"type":"string"},"type":"array","title":"Signals"},"extra_signal_count":{"type":"integer","title":"Extra Signal Count","default":0},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"sic_descriptions":{"items":{"type":"string"},"type":"array","title":"Sic Descriptions"},"sector_label":{"type":"string","title":"Sector Label","default":""},"active_profile":{"type":"string","enum":["investor","recruiting","advertising","sales"],"title":"Active Profile","default":"investor"},"primary_score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Primary Score"},"ranking_profiles":{"additionalProperties":{"$ref":"#/components/schemas/RankingProfileScore"},"propertyNames":{"enum":["investor","recruiting","advertising","sales"]},"type":"object","title":"Ranking Profiles"},"ranking_version":{"type":"string","title":"Ranking Version","default":""},"ranked_at":{"type":"string","title":"Ranked At","default":""},"ranking_input_hash":{"type":"string","title":"Ranking Input Hash","default":""},"top_founder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Founder Name"},"founder_appointment_count":{"type":"integer","minimum":0.0,"title":"Founder Appointment Count","default":0},"founder_active_companies":{"type":"integer","minimum":0.0,"title":"Founder Active Companies","default":0},"founder_dissolved_companies":{"type":"integer","minimum":0.0,"title":"Founder Dissolved Companies","default":0},"founder_repeat_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Founder Repeat Score","default":0},"director_count":{"type":"integer","minimum":0.0,"title":"Director Count","default":0},"active_director_count":{"type":"integer","minimum":0.0,"title":"Active Director Count","default":0},"accounts_overdue":{"type":"boolean","title":"Accounts Overdue","default":false},"confirmation_overdue":{"type":"boolean","title":"Confirmation Overdue","default":false},"accounts_days_overdue":{"type":"integer","minimum":0.0,"title":"Accounts Days Overdue","default":0},"accounts_days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Accounts Days Until Due"},"confirmation_days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confirmation Days Until Due"},"company_status":{"type":"string","title":"Company Status","default":"active"},"company_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status Detail"},"accounts_status":{"type":"string","title":"Accounts Status","default":"unknown"},"confirmation_status":{"type":"string","title":"Confirmation Status","default":"unknown"},"overall_compliance_status":{"type":"string","title":"Overall Compliance Status","default":"unknown"},"compliance_issues":{"items":{"type":"string"},"type":"array","title":"Compliance Issues"},"risk_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Risk Score","default":0},"summary":{"type":"string","title":"Summary"},"status":{"type":"string","title":"Status","default":"unknown"},"company_type":{"type":"string","title":"Company Type","default":"unknown"},"registered_office_address":{"additionalProperties":{"type":"string"},"type":"object","title":"Registered Office Address"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"why_this_matched":{"items":{"type":"string"},"type":"array","title":"Why This Matched"},"relevance_breakdown":{"items":{"$ref":"#/components/schemas/RelevanceBreakdown"},"type":"array","title":"Relevance Breakdown"},"founder_history":{"items":{"$ref":"#/components/schemas/FounderHistory"},"type":"array","title":"Founder History"},"psc_links":{"items":{"$ref":"#/components/schemas/PscLink"},"type":"array","title":"Psc Links"},"documents":{"items":{"$ref":"#/components/schemas/DocumentItem"},"type":"array","title":"Documents"},"charges_count":{"type":"integer","title":"Charges Count","default":0},"has_insolvency":{"type":"boolean","title":"Has Insolvency","default":false},"insolvency_cases":{"type":"integer","title":"Insolvency Cases","default":0},"risk_signals":{"items":{"$ref":"#/components/schemas/CompanyRiskSignal"},"type":"array","title":"Risk Signals"},"founder_graph_summary":{"type":"string","title":"Founder Graph Summary","default":""}},"type":"object","required":["company_number","company_name","incorporated_on","age_label","location","postcode","signals","startup_relevance_score","summary"],"title":"CompanyDetail"},"CompanyMatch":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"incorporated_on":{"type":"string","title":"Incorporated On"},"age_label":{"type":"string","title":"Age Label"},"location":{"type":"string","title":"Location"},"postcode":{"type":"string","title":"Postcode"},"signals":{"items":{"type":"string"},"type":"array","title":"Signals"},"extra_signal_count":{"type":"integer","title":"Extra Signal Count","default":0},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"sic_descriptions":{"items":{"type":"string"},"type":"array","title":"Sic Descriptions"},"sector_label":{"type":"string","title":"Sector Label","default":""},"active_profile":{"type":"string","enum":["investor","recruiting","advertising","sales"],"title":"Active Profile","default":"investor"},"primary_score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Primary Score"},"ranking_profiles":{"additionalProperties":{"$ref":"#/components/schemas/RankingProfileScore"},"propertyNames":{"enum":["investor","recruiting","advertising","sales"]},"type":"object","title":"Ranking Profiles"},"ranking_version":{"type":"string","title":"Ranking Version","default":""},"ranked_at":{"type":"string","title":"Ranked At","default":""},"ranking_input_hash":{"type":"string","title":"Ranking Input Hash","default":""},"top_founder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Founder Name"},"founder_appointment_count":{"type":"integer","minimum":0.0,"title":"Founder Appointment Count","default":0},"founder_active_companies":{"type":"integer","minimum":0.0,"title":"Founder Active Companies","default":0},"founder_dissolved_companies":{"type":"integer","minimum":0.0,"title":"Founder Dissolved Companies","default":0},"founder_repeat_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Founder Repeat Score","default":0},"director_count":{"type":"integer","minimum":0.0,"title":"Director Count","default":0},"active_director_count":{"type":"integer","minimum":0.0,"title":"Active Director Count","default":0},"accounts_overdue":{"type":"boolean","title":"Accounts Overdue","default":false},"confirmation_overdue":{"type":"boolean","title":"Confirmation Overdue","default":false},"accounts_days_overdue":{"type":"integer","minimum":0.0,"title":"Accounts Days Overdue","default":0},"accounts_days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Accounts Days Until Due"},"confirmation_days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confirmation Days Until Due"},"company_status":{"type":"string","title":"Company Status","default":"active"},"company_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status Detail"},"accounts_status":{"type":"string","title":"Accounts Status","default":"unknown"},"confirmation_status":{"type":"string","title":"Confirmation Status","default":"unknown"},"overall_compliance_status":{"type":"string","title":"Overall Compliance Status","default":"unknown"},"compliance_issues":{"items":{"type":"string"},"type":"array","title":"Compliance Issues"},"risk_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Risk Score","default":0}},"type":"object","required":["company_number","company_name","incorporated_on","age_label","location","postcode","signals","startup_relevance_score"],"title":"CompanyMatch"},"CompanyPublicPreview":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"company_status":{"type":"string","title":"Company Status","default":"unknown"},"company_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status Detail"},"incorporated_on":{"type":"string","title":"Incorporated On","default":""},"location":{"type":"string","title":"Location","default":"UK"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"sic_descriptions":{"items":{"type":"string"},"type":"array","title":"Sic Descriptions"},"sector_label":{"type":"string","title":"Sector Label","default":""},"risk_score":{"type":"integer","title":"Risk Score","default":0},"risk_signals":{"items":{"$ref":"#/components/schemas/CompanyRiskSignal"},"type":"array","title":"Risk Signals"},"source_url":{"type":"string","title":"Source Url"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["company_number","company_name","source_url","summary"],"title":"CompanyPublicPreview"},"CompanyRiskSignal":{"properties":{"code":{"type":"string","title":"Code"},"label":{"type":"string","title":"Label"},"severity":{"type":"string","title":"Severity","default":"medium"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["code","label"],"title":"CompanyRiskSignal"},"CompanySearchResponse":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"search_type":{"type":"string","title":"Search Type","default":"recent"},"total":{"type":"integer","title":"Total"},"matches":{"items":{"$ref":"#/components/schemas/CompanyMatch"},"type":"array","title":"Matches"},"tier_limited":{"type":"boolean","title":"Tier Limited","default":false},"result_cap":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Result Cap"},"total_available":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Available"}},"type":"object","required":["total","matches"],"title":"CompanySearchResponse"},"ComplianceBatchError":{"properties":{"company_number":{"type":"string","title":"Company Number"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["company_number","detail"],"title":"ComplianceBatchError"},"ComplianceBatchRequest":{"properties":{"company_numbers":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Company Numbers"}},"type":"object","required":["company_numbers"],"title":"ComplianceBatchRequest"},"ComplianceBatchResponse":{"properties":{"reports":{"items":{"$ref":"#/components/schemas/CompanyComplianceReport"},"type":"array","title":"Reports"},"errors":{"items":{"$ref":"#/components/schemas/ComplianceBatchError"},"type":"array","title":"Errors"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","title":"ComplianceBatchResponse"},"ComplianceFilingRecord":{"properties":{"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"filed_on":{"type":"string","title":"Filed On"},"transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Id"},"document_metadata_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Metadata Url"},"document_download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Download Url"},"filing_history_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing History Url"},"downloadable":{"type":"boolean","title":"Downloadable","default":false}},"type":"object","required":["category","description","filed_on"],"title":"ComplianceFilingRecord"},"ConfirmationCompliance":{"properties":{"last_made_up_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Made Up To"},"next_due_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Due On"},"next_made_up_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Made Up To"},"overdue":{"type":"boolean","title":"Overdue","default":false},"status":{"$ref":"#/components/schemas/FilingStatus","default":"unknown"},"days_until_due":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Until Due"}},"type":"object","title":"ConfirmationCompliance"},"DashboardPayload":{"properties":{"matches":{"items":{"$ref":"#/components/schemas/CompanyMatch"},"type":"array","title":"Matches"},"selected_company":{"anyOf":[{"$ref":"#/components/schemas/CompanyDetail"},{"type":"null"}]},"trends":{"items":{"$ref":"#/components/schemas/TrendCard"},"type":"array","title":"Trends"},"repeat_founder_activity":{"type":"integer","title":"Repeat Founder Activity"},"hotspots":{"items":{"$ref":"#/components/schemas/HotspotFeature"},"type":"array","title":"Hotspots"},"map_style_url":{"type":"string","title":"Map Style Url","default":""}},"type":"object","required":["repeat_founder_activity"],"title":"DashboardPayload"},"DirectorSignal":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"incorporated_on":{"type":"string","title":"Incorporated On"},"location":{"type":"string","title":"Location"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score"},"director_count":{"type":"integer","title":"Director Count","default":0},"active_director_count":{"type":"integer","title":"Active Director Count","default":0},"action":{"type":"string","title":"Action"}},"type":"object","required":["company_number","company_name","incorporated_on","location","startup_relevance_score","action"],"title":"DirectorSignal"},"DocumentItem":{"properties":{"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"filed_on":{"type":"string","title":"Filed On"},"transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Id"},"document_metadata_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Metadata Url"},"document_download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Download Url"},"filing_history_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing History Url"},"downloadable":{"type":"boolean","title":"Downloadable","default":false}},"type":"object","required":["category","description","filed_on"],"title":"DocumentItem"},"E2eSubscriptionRequest":{"properties":{"org_id":{"type":"string","title":"Org Id"},"tier":{"type":"string","pattern":"^(free|scout|scout_annual|fund|platform)$","title":"Tier"}},"type":"object","required":["org_id","tier"],"title":"E2eSubscriptionRequest"},"E2eUsageResetRequest":{"properties":{"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["org_id"],"title":"E2eUsageResetRequest"},"EventCountRow":{"properties":{"event":{"type":"string","title":"Event"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["event","count"],"title":"EventCountRow"},"FilingStatus":{"type":"string","enum":["overdue","due_30","due_90","ok","unknown"],"title":"FilingStatus"},"FilingSummary":{"properties":{"company_number":{"type":"string","title":"Company Number"},"transaction_id":{"type":"string","title":"Transaction Id"},"filing_type":{"type":"string","title":"Filing Type","default":""},"period_covered":{"type":"string","title":"Period Covered","default":""},"summary":{"type":"string","title":"Summary","default":""},"key_figures":{"items":{"type":"string"},"type":"array","title":"Key Figures"},"auditor_mention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auditor Mention"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["company_number","transaction_id","generated_at"],"title":"FilingSummary"},"ForgotPasswordRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"ForgotPasswordRequest"},"FounderHistory":{"properties":{"name":{"type":"string","title":"Name"},"company":{"type":"string","title":"Company"},"status":{"type":"string","title":"Status"},"outcome":{"type":"string","title":"Outcome"},"officer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Officer Id"},"appointment_count":{"type":"integer","title":"Appointment Count","default":0},"companies_active":{"type":"integer","title":"Companies Active","default":0},"companies_dissolved":{"type":"integer","title":"Companies Dissolved","default":0},"software_companies":{"type":"integer","title":"Software Companies","default":0},"property_companies":{"type":"integer","title":"Property Companies","default":0},"repeat_founder_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Repeat Founder Score","default":0}},"type":"object","required":["name","company","status","outcome"],"title":"FounderHistory"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HotspotCompany":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"}},"type":"object","required":["company_number","company_name","startup_relevance_score"],"title":"HotspotCompany"},"HotspotFeature":{"properties":{"outcode":{"type":"string","title":"Outcode"},"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"count":{"type":"integer","minimum":1.0,"title":"Count"},"avg_score":{"type":"number","title":"Avg Score"},"sic_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sic Counts"},"companies":{"items":{"$ref":"#/components/schemas/HotspotCompany"},"type":"array","title":"Companies"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"admin_district":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin District"}},"type":"object","required":["outcode","latitude","longitude","count","avg_score"],"title":"HotspotFeature"},"LegalConfig":{"properties":{"app_name":{"type":"string","title":"App Name"},"operator_name":{"type":"string","title":"Operator Name"},"company_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Number"},"registered_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Address"},"contact_email":{"type":"string","title":"Contact Email"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"configured":{"type":"boolean","title":"Configured","default":false}},"type":"object","required":["app_name","operator_name","contact_email","jurisdiction"],"title":"LegalConfig"},"LiveFeedEvent":{"properties":{"timepoint":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Timepoint"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"company_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Number"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"resource_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Kind"},"received_at":{"type":"string","title":"Received At"}},"type":"object","required":["received_at"],"title":"LiveFeedEvent"},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password","default":""}},"type":"object","required":["email"],"title":"LoginRequest"},"MetricsEventIn":{"properties":{"event":{"type":"string","title":"Event"},"properties":{"additionalProperties":true,"type":"object","title":"Properties"}},"type":"object","required":["event"],"title":"MetricsEventIn"},"NewCompaniesPublicResponse":{"properties":{"days":{"type":"integer","title":"Days"},"sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sic"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"count":{"type":"integer","title":"Count"},"companies":{"items":{"$ref":"#/components/schemas/NewCompanyPublicItem"},"type":"array","title":"Companies"}},"type":"object","required":["days","count"],"title":"NewCompaniesPublicResponse"},"NewCompanyPublicItem":{"properties":{"company_number":{"type":"string","title":"Company Number"},"name":{"type":"string","title":"Name"},"incorporated_on":{"type":"string","title":"Incorporated On"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"location":{"type":"string","title":"Location","default":"UK"},"status":{"type":"string","title":"Status","default":"active"},"public_url":{"type":"string","title":"Public Url"}},"type":"object","required":["company_number","name","incorporated_on","public_url"],"title":"NewCompanyPublicItem"},"NotificationTestRequest":{"properties":{"channel":{"type":"string","const":"email","title":"Channel","default":"email"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"message":{"type":"string","title":"Message","default":"IncorpSignal alert test: email delivery is connected."}},"type":"object","title":"NotificationTestRequest"},"NotificationTestResponse":{"properties":{"channel":{"type":"string","title":"Channel"},"status":{"type":"string","title":"Status"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["channel","status"],"title":"NotificationTestResponse"},"OfficerActionSignal":{"properties":{"audience":{"type":"string","title":"Audience"},"label":{"type":"string","title":"Label"},"score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Score"},"action":{"type":"string","title":"Action"},"company_count":{"type":"integer","title":"Company Count"},"company_numbers":{"items":{"type":"string"},"type":"array","title":"Company Numbers"}},"type":"object","required":["audience","label","score","action","company_count"],"title":"OfficerActionSignal"},"OfficerAppointmentCompany":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"company_status":{"type":"string","title":"Company Status","default":"unknown"},"company_status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status Detail"},"officer_role":{"type":"string","title":"Officer Role","default":"officer"},"appointed_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Appointed On"},"resigned_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resigned On"},"incorporated_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporated On"},"age_label":{"type":"string","title":"Age Label","default":"live"},"location":{"type":"string","title":"Location","default":"UK"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"sic_descriptions":{"items":{"type":"string"},"type":"array","title":"Sic Descriptions"},"sector":{"type":"string","title":"Sector","default":"Unclassified"},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score","default":50},"charges_count":{"type":"integer","title":"Charges Count","default":0},"has_insolvency":{"type":"boolean","title":"Has Insolvency","default":false},"insolvency_cases":{"type":"integer","title":"Insolvency Cases","default":0},"accounts_overdue":{"type":"boolean","title":"Accounts Overdue","default":false},"confirmation_overdue":{"type":"boolean","title":"Confirmation Overdue","default":false},"risk_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Risk Score","default":0},"risk_signals":{"items":{"$ref":"#/components/schemas/CompanyRiskSignal"},"type":"array","title":"Risk Signals"}},"type":"object","required":["company_number","company_name"],"title":"OfficerAppointmentCompany"},"OfficerIntelligence":{"properties":{"officer_id":{"type":"string","title":"Officer Id"},"officer_name":{"type":"string","title":"Officer Name"},"date_of_birth_month":{"anyOf":[{"type":"integer","maximum":12.0,"minimum":1.0},{"type":"null"}],"title":"Date Of Birth Month"},"date_of_birth_year":{"anyOf":[{"type":"integer","maximum":2100.0,"minimum":1850.0},{"type":"null"}],"title":"Date Of Birth Year"},"estimated_age_min":{"anyOf":[{"type":"integer","maximum":150.0,"minimum":0.0},{"type":"null"}],"title":"Estimated Age Min"},"estimated_age_max":{"anyOf":[{"type":"integer","maximum":150.0,"minimum":0.0},{"type":"null"}],"title":"Estimated Age Max"},"age_band":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Band"},"longest_active_tenure_years":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Longest Active Tenure Years"},"succession_planning_signal":{"type":"string","title":"Succession Planning Signal","default":"unknown"},"succession_planning_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Succession Planning Reason"},"appointment_count":{"type":"integer","title":"Appointment Count"},"active_count":{"type":"integer","title":"Active Count"},"dissolved_count":{"type":"integer","title":"Dissolved Count"},"resigned_count":{"type":"integer","title":"Resigned Count"},"software_data_count":{"type":"integer","title":"Software Data Count"},"property_count":{"type":"integer","title":"Property Count"},"repeat_founder_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Repeat Founder Score"},"profiled_company_count":{"type":"integer","title":"Profiled Company Count"},"status_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Status Counts"},"risk_flagged_company_count":{"type":"integer","title":"Risk Flagged Company Count","default":0},"risk_highlights":{"items":{"type":"string"},"type":"array","title":"Risk Highlights"},"companies":{"items":{"$ref":"#/components/schemas/OfficerAppointmentCompany"},"type":"array","title":"Companies"},"sic_clusters":{"items":{"$ref":"#/components/schemas/OfficerSicCluster"},"type":"array","title":"Sic Clusters"},"sector_clusters":{"items":{"$ref":"#/components/schemas/OfficerSectorCluster"},"type":"array","title":"Sector Clusters"},"actions":{"items":{"$ref":"#/components/schemas/OfficerActionSignal"},"type":"array","title":"Actions"},"source_url":{"type":"string","title":"Source Url"}},"type":"object","required":["officer_id","officer_name","appointment_count","active_count","dissolved_count","resigned_count","software_data_count","property_count","repeat_founder_score","profiled_company_count","source_url"],"title":"OfficerIntelligence"},"OfficerSectorCluster":{"properties":{"sector":{"type":"string","title":"Sector"},"count":{"type":"integer","title":"Count"},"active_count":{"type":"integer","title":"Active Count"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"companies":{"items":{"$ref":"#/components/schemas/OfficerAppointmentCompany"},"type":"array","title":"Companies"}},"type":"object","required":["sector","count","active_count"],"title":"OfficerSectorCluster"},"OfficerSicCluster":{"properties":{"sic_code":{"type":"string","title":"Sic Code"},"description":{"type":"string","title":"Description"},"sector":{"type":"string","title":"Sector"},"count":{"type":"integer","title":"Count"},"active_count":{"type":"integer","title":"Active Count"},"companies":{"items":{"$ref":"#/components/schemas/OfficerAppointmentCompany"},"type":"array","title":"Companies"}},"type":"object","required":["sic_code","description","sector","count","active_count"],"title":"OfficerSicCluster"},"PasswordChangeRequest":{"properties":{"current_password":{"type":"string","title":"Current Password","default":""},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["new_password"],"title":"PasswordChangeRequest"},"PersonaOpportunity":{"properties":{"persona":{"type":"string","title":"Persona"},"label":{"type":"string","title":"Label"},"count":{"type":"integer","title":"Count"},"avg_score":{"type":"number","title":"Avg Score"},"threshold":{"type":"integer","title":"Threshold"},"action":{"type":"string","title":"Action"},"top_companies":{"items":{"$ref":"#/components/schemas/TrendCompany"},"type":"array","title":"Top Companies"}},"type":"object","required":["persona","label","count","avg_score","threshold","action"],"title":"PersonaOpportunity"},"PscLink":{"properties":{"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"},"kind":{"type":"string","title":"Kind","default":"psc"}},"type":"object","required":["name","role"],"title":"PscLink"},"PublicSearchRecommendation":{"properties":{"label":{"type":"string","title":"Label"},"query":{"type":"string","title":"Query"},"reason":{"type":"string","title":"Reason"},"url":{"type":"string","title":"Url"},"type":{"type":"string","enum":["search","signal","sic","location","trends","api","curated"],"title":"Type"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"}},"type":"object","required":["label","query","reason","url","type"],"title":"PublicSearchRecommendation"},"RankingComponent":{"properties":{"label":{"type":"string","title":"Label"},"score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Score"},"weight":{"type":"number","minimum":0.0,"title":"Weight","default":1.0}},"type":"object","required":["label","score"],"title":"RankingComponent"},"RankingProfileScore":{"properties":{"score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Score"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.65},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"components":{"items":{"$ref":"#/components/schemas/RankingComponent"},"type":"array","title":"Components"},"labels":{"additionalProperties":true,"type":"object","title":"Labels"},"version":{"type":"string","title":"Version","default":"ranker-v1"},"ranked_at":{"type":"string","title":"Ranked At","default":""},"input_hash":{"type":"string","title":"Input Hash","default":""}},"type":"object","required":["score"],"title":"RankingProfileScore"},"RelevanceBreakdown":{"properties":{"label":{"type":"string","title":"Label"},"score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Score"}},"type":"object","required":["label","score"],"title":"RelevanceBreakdown"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest"},"SearchDsl":{"properties":{"sectors":{"items":{"type":"string"},"type":"array","title":"Sectors","default":[]},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes","default":[]},"locations":{"items":{"type":"string"},"type":"array","title":"Locations","default":[]},"incorporated_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporated From"},"incorporated_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporated To"},"repeat_founder":{"type":"boolean","title":"Repeat Founder","default":false},"psc_match":{"type":"boolean","title":"Psc Match","default":false},"min_startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Min Startup Relevance Score","default":0},"ranking_profile":{"type":"string","enum":["investor","recruiting","advertising","sales"],"title":"Ranking Profile","default":"investor"},"min_profile_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Min Profile Score","default":0},"founder_focus":{"type":"boolean","title":"Founder Focus","default":false},"min_founder_appointments":{"type":"integer","minimum":0.0,"title":"Min Founder Appointments","default":0},"min_director_count":{"type":"integer","minimum":0.0,"title":"Min Director Count","default":0},"accounts_overdue":{"type":"boolean","title":"Accounts Overdue","default":false},"confirmation_overdue":{"type":"boolean","title":"Confirmation Overdue","default":false},"accounts_due":{"type":"boolean","title":"Accounts Due","default":false},"confirmation_due":{"type":"boolean","title":"Confirmation Due","default":false},"accounts_due_within_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":0.0},{"type":"null"}],"title":"Accounts Due Within Days"},"confirmation_due_within_days":{"anyOf":[{"type":"integer","maximum":3650.0,"minimum":0.0},{"type":"null"}],"title":"Confirmation Due Within Days"},"postcodes":{"items":{"type":"string"},"type":"array","title":"Postcodes","default":[]},"company_statuses":{"items":{"type":"string"},"type":"array","title":"Company Statuses","default":[]},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sort By"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":25},"raw_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Query"},"parser_source":{"type":"string","title":"Parser Source","default":"heuristic"},"parser_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parser Model"}},"additionalProperties":false,"type":"object","title":"SearchDsl"},"SearchRecommendationsResponse":{"properties":{"query":{"type":"string","title":"Query"},"parser_source":{"type":"string","title":"Parser Source","default":"heuristic"},"count":{"type":"integer","title":"Count"},"recommendations":{"items":{"$ref":"#/components/schemas/PublicSearchRecommendation"},"type":"array","title":"Recommendations"}},"type":"object","required":["query","count"],"title":"SearchRecommendationsResponse"},"SectorMixItem":{"properties":{"sector":{"type":"string","title":"Sector"},"count":{"type":"integer","title":"Count"},"share":{"type":"number","title":"Share"},"avg_score":{"type":"number","title":"Avg Score"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"action":{"type":"string","title":"Action"},"top_companies":{"items":{"$ref":"#/components/schemas/TrendCompany"},"type":"array","title":"Top Companies"},"company_numbers":{"items":{"type":"string"},"type":"array","title":"Company Numbers"},"matches":{"items":{"$ref":"#/components/schemas/CompanyMatch"},"type":"array","title":"Matches"}},"type":"object","required":["sector","count","share","avg_score","action"],"title":"SectorMixItem"},"SemanticSearchPublicHit":{"properties":{"company_number":{"type":"string","title":"Company Number"},"name":{"type":"string","title":"Name"},"score":{"type":"number","title":"Score"},"location":{"type":"string","title":"Location","default":"UK"},"incorporated_on":{"type":"string","title":"Incorporated On","default":""},"status":{"type":"string","title":"Status","default":"active"},"public_url":{"type":"string","title":"Public Url"}},"type":"object","required":["company_number","name","score","public_url"],"title":"SemanticSearchPublicHit"},"SemanticSearchPublicResponse":{"properties":{"query":{"type":"string","title":"Query"},"count":{"type":"integer","title":"Count"},"hits":{"items":{"$ref":"#/components/schemas/SemanticSearchPublicHit"},"type":"array","title":"Hits"},"recommendations":{"items":{"$ref":"#/components/schemas/PublicSearchRecommendation"},"type":"array","title":"Recommendations"}},"type":"object","required":["query","count"],"title":"SemanticSearchPublicResponse"},"SicCluster":{"properties":{"sic_code":{"type":"string","title":"Sic Code"},"description":{"type":"string","title":"Description"},"sector":{"type":"string","title":"Sector"},"count":{"type":"integer","title":"Count"},"share":{"type":"number","title":"Share"},"avg_score":{"type":"number","title":"Avg Score"},"action":{"type":"string","title":"Action"},"top_companies":{"items":{"$ref":"#/components/schemas/TrendCompany"},"type":"array","title":"Top Companies"},"company_numbers":{"items":{"type":"string"},"type":"array","title":"Company Numbers"},"matches":{"items":{"$ref":"#/components/schemas/CompanyMatch"},"type":"array","title":"Matches"}},"type":"object","required":["sic_code","description","sector","count","share","avg_score","action"],"title":"SicCluster"},"SicPublicPage":{"properties":{"code":{"type":"string","title":"Code"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector"},"related_codes":{"items":{"type":"string"},"type":"array","title":"Related Codes"},"search_query":{"type":"string","title":"Search Query"},"companies_house_url":{"type":"string","title":"Companies House Url"},"companies":{"items":{"$ref":"#/components/schemas/NewCompanyPublicItem"},"type":"array","title":"Companies"}},"type":"object","required":["code","title","description","search_query","companies_house_url"],"title":"SicPublicPage"},"SignalLandingFaq":{"properties":{"question":{"type":"string","title":"Question"},"answer":{"type":"string","title":"Answer"}},"type":"object","required":["question","answer"],"title":"SignalLandingFaq"},"SignalLandingPage":{"properties":{"slug":{"type":"string","title":"Slug"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"days":{"type":"integer","title":"Days","default":30},"companies":{"items":{"$ref":"#/components/schemas/NewCompanyPublicItem"},"type":"array","title":"Companies"},"faq":{"items":{"$ref":"#/components/schemas/SignalLandingFaq"},"type":"array","title":"Faq"}},"type":"object","required":["slug","title","description"],"title":"SignalLandingPage"},"SignupRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password","default":""},"name":{"type":"string","title":"Name","default":""},"org_name":{"type":"string","title":"Org Name","default":""}},"type":"object","required":["email"],"title":"SignupRequest"},"SubscriptionState":{"properties":{"org_id":{"type":"string","title":"Org Id"},"stripe_customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Customer Id"},"stripe_subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Subscription Id"},"status":{"type":"string","title":"Status","default":"inactive"},"entitlements":{"items":{"type":"string"},"type":"array","title":"Entitlements"},"tier":{"type":"string","title":"Tier","default":"free"},"access_source":{"type":"string","title":"Access Source","default":"billing"}},"type":"object","required":["org_id"],"title":"SubscriptionState"},"TopSearchRow":{"properties":{"query":{"type":"string","title":"Query"},"count":{"type":"integer","title":"Count"},"last_seen":{"type":"string","title":"Last Seen","default":""}},"type":"object","required":["query","count"],"title":"TopSearchRow"},"TrendCard":{"properties":{"title":{"type":"string","title":"Title"},"subtitle":{"type":"string","title":"Subtitle"},"points":{"items":{"$ref":"#/components/schemas/TrendPoint"},"type":"array","title":"Points"}},"type":"object","required":["title","subtitle","points"],"title":"TrendCard"},"TrendCompany":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"incorporated_on":{"type":"string","title":"Incorporated On"},"location":{"type":"string","title":"Location"},"startup_relevance_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Startup Relevance Score"},"primary_score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Primary Score"},"sic_codes":{"items":{"type":"string"},"type":"array","title":"Sic Codes"}},"type":"object","required":["company_number","company_name","incorporated_on","location","startup_relevance_score"],"title":"TrendCompany"},"TrendPoint":{"properties":{"label":{"type":"string","title":"Label"},"value":{"type":"integer","title":"Value"},"previous":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous"}},"type":"object","required":["label","value"],"title":"TrendPoint"},"TrendSummary":{"properties":{"window_days":{"type":"integer","title":"Window Days"},"total_companies":{"type":"integer","title":"Total Companies"},"source":{"type":"string","title":"Source"},"latest_incorporation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Incorporation Date"},"high_signal_companies":{"type":"integer","title":"High Signal Companies","default":0},"repeat_founder_companies":{"type":"integer","title":"Repeat Founder Companies","default":0},"companies_with_sic":{"type":"integer","title":"Companies With Sic","default":0},"avg_investor_score":{"type":"number","title":"Avg Investor Score","default":0}},"type":"object","required":["window_days","total_companies","source"],"title":"TrendSummary"},"TrendsResponse":{"properties":{"trends":{"items":{"$ref":"#/components/schemas/TrendCard"},"type":"array","title":"Trends"},"repeat_founder_activity":{"type":"integer","title":"Repeat Founder Activity"},"source":{"type":"string","title":"Source"},"hotspots":{"items":{"$ref":"#/components/schemas/HotspotFeature"},"type":"array","title":"Hotspots"},"map_style_url":{"type":"string","title":"Map Style Url"},"summary":{"anyOf":[{"$ref":"#/components/schemas/TrendSummary"},{"type":"null"}]},"sector_mix":{"items":{"$ref":"#/components/schemas/SectorMixItem"},"type":"array","title":"Sector Mix"},"sic_clusters":{"items":{"$ref":"#/components/schemas/SicCluster"},"type":"array","title":"Sic Clusters"},"persona_opportunities":{"items":{"$ref":"#/components/schemas/PersonaOpportunity"},"type":"array","title":"Persona Opportunities"},"director_signals":{"items":{"$ref":"#/components/schemas/DirectorSignal"},"type":"array","title":"Director Signals"},"action_queue":{"items":{"$ref":"#/components/schemas/ActionQueueItem"},"type":"array","title":"Action Queue"}},"type":"object","required":["repeat_founder_activity","source","map_style_url"],"title":"TrendsResponse"},"UserSession":{"properties":{"user_id":{"type":"string","title":"User Id"},"org_id":{"type":"string","title":"Org Id"},"email":{"type":"string","format":"email","title":"Email"},"name":{"type":"string","title":"Name"},"entitlements":{"items":{"type":"string"},"type":"array","title":"Entitlements"},"session_expires_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Session Expires At"}},"type":"object","required":["user_id","org_id","email","name","entitlements"],"title":"UserSession"},"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"},"WatchlistCreate":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"incorporated_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporated On"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"company_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status"},"overall_compliance_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Overall Compliance Status"},"compliance_issues":{"items":{"type":"string"},"type":"array","title":"Compliance Issues"}},"additionalProperties":false,"type":"object","required":["company_number","company_name"],"title":"WatchlistCreate"},"WatchlistEntry":{"properties":{"company_number":{"type":"string","title":"Company Number"},"company_name":{"type":"string","title":"Company Name"},"org_id":{"type":"string","title":"Org Id"},"user_id":{"type":"string","title":"User Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"incorporated_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incorporated On"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"company_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Status"},"overall_compliance_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Overall Compliance Status"},"compliance_issues":{"items":{"type":"string"},"type":"array","title":"Compliance Issues"}},"additionalProperties":false,"type":"object","required":["company_number","company_name","org_id","user_id","created_at"],"title":"WatchlistEntry"},"WatchlistListResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/WatchlistEntry"},"type":"array","title":"Entries"},"limit":{"type":"integer","title":"Limit"},"used":{"type":"integer","title":"Used"},"remaining":{"type":"integer","title":"Remaining"}},"type":"object","required":["entries","limit","used","remaining"],"title":"WatchlistListResponse"}}},"tags":[{"name":"v1-api","description":"Programmatic REST API (requires API key). Includes NL parse at POST /v1/nl/parse."},{"name":"api-keys","description":"Create and rotate API keys (Scout Plus)"},{"name":"agent-tokens","description":"Create and rotate MCP bearer tokens (all tiers)"},{"name":"x402","description":"Agent-native x402 pay-per-call products"},{"name":"companies","description":"Structured and DSL company search, dossiers, and live stream"},{"name":"alerts","description":"Alert rules, NL search parse (`POST /nl/search/parse`), and delivery"},{"name":"watchlist","description":"Saved company monitor list with tier-based limits"},{"name":"billing","description":"Stripe checkout and subscriptions"}]}