{ "openapi": "3.1.0", "info": { "title": "LinqConnect API", "version": "1.4.0", "description": "AI Data Aggregation and Verification for Insurance - 7 Specialized AI Agents orchestrated by custom LLM. LinqConnect delivers 20-25% more accurate business intelligence than any aggregated data source through private AI infrastructure.", "contact": { "name": "Linqura Support", "url": "https://linqura.com/contact", "email": "support@linqura.com" }, "license": { "name": "Proprietary", "url": "https://linqura.com/terms" } }, "servers": [ { "url": "https://api.linqura.ai", "description": "Production Environment" }, { "url": "https://demo-api.linqura.ai", "description": "Demo Environment (use x-api-key: advisor@2024)" } ], "security": [ { "OAuth2": [ "default-m2m-resource-server-polax1/linqdata" ] }, { "ApiKeyAuth": [] } ], "paths": { "/auth/oauth2/token": { "post": { "operationId": "getAccessToken", "summary": "OAuth2 Token Exchange", "description": "Exchange client credentials for an access token using OAuth2 Client Credentials flow.", "tags": [ "Authentication" ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "required": [ "grant_type", "client_id", "client_secret", "scope" ], "properties": { "grant_type": { "type": "string", "enum": [ "client_credentials" ], "description": "OAuth2 grant type" }, "client_id": { "type": "string", "description": "Your client ID" }, "client_secret": { "type": "string", "description": "Your client secret" }, "scope": { "type": "string", "default": "default-m2m-resource-server-polax1/linqdata", "description": "Required scope for LinqConnect access" } } } } } }, "responses": { "200": { "description": "Successful token exchange", "content": { "application/json": { "schema": { "type": "object", "properties": { "access_token": { "type": "string", "description": "JWT access token" }, "expires_in": { "type": "integer", "description": "Token expiration time in seconds (3600 = 1 hour)" }, "token_type": { "type": "string", "enum": [ "Bearer" ], "description": "Token type" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Invalid client credentials" } } } }, "/opensearch-sybl": { "get": { "operationId": "searchBusinesses", "summary": "Business Search", "description": "Search for businesses to get entity IDs for use with LinqConnect. No authentication required.", "tags": [ "Business Search" ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "example": "Thermal Dynamics Corporation West Lebanon NH" }, "description": "Search query - can include business name, address, city, state" } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BusinessSearchResponse" } } } }, "400": { "description": "Invalid search query" } } } }, "/v1/linqConnect": { "post": { "operationId": "getBusinessIntelligence", "summary": "LinqConnect Intelligence", "description": "Get comprehensive business intelligence using 7 Specialized AI Agents. Returns firmographics, risk assessment, coverage analysis, property intelligence, and more.", "tags": [ "Business Intelligence" ], "security": [ { "OAuth2": [] }, { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinqConnectRequest" } } } }, "responses": { "200": { "description": "Successful business intelligence response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinqConnectResponse" } } } }, "400": { "description": "Invalid request parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Authentication required or invalid" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HttpValidationError" } } } }, "429": { "description": "Rate limit exceeded" }, "500": { "description": "Internal server error" } } } } }, "components": { "securitySchemes": { "OAuth2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://api.linqura.ai/auth/oauth2/token", "scopes": { "default-m2m-resource-server-polax1/linqdata": "Access to LinqConnect business intelligence data" } } } }, "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Demo environment only - use advisor@2024 for testing" } }, "schemas": { "LinqConnectRequest": { "type": "object", "required": [ "enterprise_id", "access_package", "session_id", "user_id", "search_type", "features" ], "properties": { "enterprise_id": { "type": "string", "minLength": 1, "description": "Unique identifier for the enterprise or organization using the API", "example": "org001" }, "access_package": { "type": "string", "enum": [ "basic", "premium", "enterprise" ], "description": "Determines the feature access level", "example": "premium" }, "session_id": { "type": "string", "minLength": 1, "description": "Unique identifier for the user session", "example": "sess-348d569" }, "user_id": { "type": "string", "minLength": 1, "description": "User ID (mandatory)", "example": "user_45678" }, "env_name": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ], "description": "Environment name", "example": null }, "search_type": { "type": "string", "enum": [ "business", "industry" ], "description": "Type of search to perform", "example": "business" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Entity ID - business id for business search, NAICS code for industry search", "example": "536734c7d63f9a25ef2a77dc262160d6a784bfa1" }, "entity_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Entity name - business name for business search, NAICS title for industry search", "example": "Thermal Dynamics Corporation" }, "entity_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Business street address", "example": "82 Benning St" }, "entity_city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Business city", "example": "West Lebanon" }, "entity_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Business state", "example": "NH" }, "entity_zip_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Business zip code", "example": "03784" }, "features": { "type": "string", "description": "Comma-separated list of features: FIRMO, CVG, EXP, RISK, UWQ, FMCD, OSHA, WORKCOMP, PROPERTY, RISK_PROPERTY, REPLACEMENT, FLOOD, BIZCORE", "example": "FIRMO,CVG,EXP,RISK,UWQ,FMCD,OSHA,WORKCOMP,BIZCORE" } } }, "LinqConnectResponse": { "type": "object", "description": "Complete LinqConnect API response with all requested features", "properties": { "metadata": { "$ref": "#/components/schemas/MetadataObject" }, "firmo": { "$ref": "#/components/schemas/FirmoObject" }, "property_attributes": { "$ref": "#/components/schemas/PropertyAttributesObject" }, "property_risk": { "$ref": "#/components/schemas/PropertyRiskObject" }, "replacement_cost": { "$ref": "#/components/schemas/ReplacementCostObject" }, "insurance_coverage": { "$ref": "#/components/schemas/InsuranceCoverageObject" }, "key_exposures": { "type": "array", "items": { "$ref": "#/components/schemas/ExposureItem" } }, "risk_assessment": { "type": "array", "items": { "$ref": "#/components/schemas/RiskAssessmentItem" } }, "fmcd": { "$ref": "#/components/schemas/FmcdObject" }, "osha": { "$ref": "#/components/schemas/OshaObject" }, "workcomp": { "$ref": "#/components/schemas/WorkcompObject" }, "flood": { "$ref": "#/components/schemas/FloodObject" }, "bizcore": { "$ref": "#/components/schemas/BizcoreObject" }, "underwriting_questions": { "type": "array", "items": { "$ref": "#/components/schemas/UnderwritingQuestionCategory" }, "description": "Industry-specific underwriting questions organized by category" } } }, "MetadataObject": { "type": "object", "description": "Request metadata echoed back with response status", "properties": { "enterprise_id": { "type": "string", "description": "Enterprise identifier from request", "example": "admin" }, "session_id": { "type": "string", "description": "Session identifier from request", "example": "sess-348d569" }, "user_id": { "type": "string", "description": "User identifier from request", "example": "a58f1dbe-112b-4e05-ad16-1a05e1562ec8" }, "env_name": { "type": [ "string", "null" ], "description": "Environment name", "example": null }, "search_type": { "type": "string", "enum": [ "business", "industry" ], "description": "Type of search performed", "example": "business" }, "entity_id": { "type": "string", "description": "Matched entity identifier", "example": "536734c7d63f9a25ef2a77dc262160d6a784bfa1" }, "entity_name": { "type": "string", "description": "Business name", "example": "Thermal Dynamics Corporation dba Thermadyne" }, "entity_address": { "type": "string", "description": "Business address", "example": "82 Benning St" }, "entity_city": { "type": "string", "description": "Business city", "example": "West Lebanon" }, "entity_state": { "type": "string", "description": "Business state", "example": "NH" }, "features": { "type": "array", "items": { "type": "string" }, "description": "List of features processed", "example": [ "firmo", "cvg", "exp", "risk", "uwq", "fmcd", "osha", "property", "risk_property", "replacement", "flood" ] }, "access_package": { "type": "string", "enum": [ "basic", "premium", "enterprise" ], "description": "Access package level", "example": "premium" }, "status": { "type": "string", "enum": [ "success", "partial", "failed" ], "description": "Overall request status", "example": "success" }, "timestamp": { "type": "string", "format": "date-time", "description": "Response timestamp", "example": "2025-11-21T19:48:59.310810" } } }, "FirmoObject": { "type": "object", "description": "Comprehensive business firmographics and intelligence", "properties": { "business_information": { "$ref": "#/components/schemas/BusinessInformation" }, "classification": { "$ref": "#/components/schemas/ClassificationObject" }, "metrics": { "$ref": "#/components/schemas/BusinessMetrics" }, "product_services": { "type": "array", "items": { "$ref": "#/components/schemas/ProductService" } }, "industry_keywords": { "type": "array", "items": { "type": "string" }, "description": "Industry-specific keywords", "example": [ "Machine Tools", "Metal Cutting", "Industrial Machinery" ] }, "additional_data": { "$ref": "#/components/schemas/AdditionalBusinessData" } } }, "BusinessInformation": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique business identifier", "example": "536734c7d63f9a25ef2a77dc262160d6a784bfa1" }, "name": { "type": "string", "description": "Legal business name", "example": "Thermal Dynamics Corporation" }, "dba_name": { "type": [ "string", "null" ], "description": "Doing Business As name", "example": "Thermadyne" }, "location": { "$ref": "#/components/schemas/LocationObject" }, "start_year": { "type": "integer", "description": "Year business was established", "example": 1917 }, "website": { "type": [ "string", "null" ], "description": "Business website URL", "example": "www.thermal-dynamics.com" }, "description": { "type": "string", "description": "AI-generated business description" }, "business_match_score": { "type": "number", "minimum": 0, "maximum": 1, "description": "Confidence score for business match", "example": 1 }, "description_source": { "type": ["string", "null"], "description": "Source of business description (original, generated, etc.)", "example": "original" } } }, "LocationObject": { "type": "object", "properties": { "street_address": { "type": "string", "description": "Street address", "example": "82 Benning St" }, "city": { "type": "string", "description": "City name", "example": "West Lebanon" }, "state": { "type": "string", "description": "State abbreviation", "example": "NH" }, "zip_code": { "type": "string", "description": "ZIP code", "example": "3784" }, "latitude": { "type": "number", "description": "Latitude coordinate", "example": 43.63240433 }, "longitude": { "type": "number", "description": "Longitude coordinate", "example": -72.31119537 } } }, "ClassificationObject": { "type": "object", "description": "Complete business classification across multiple systems", "properties": { "primary_naics_verified": { "$ref": "#/components/schemas/NaicsVerification" }, "primary_naics_code": { "type": "integer", "description": "Primary NAICS classification code", "example": 333517 }, "primary_naics_title": { "type": "string", "description": "Primary NAICS description", "example": "Machine Tool Manufacturing" }, "secondary_naics_code": { "type": "integer", "description": "Secondary NAICS classification code", "example": 333515 }, "secondary_naics_title": { "type": "string", "description": "Secondary NAICS description", "example": "Cutting Tool and Machine Tool Accessory Manufacturing" }, "compensation": { "type": "array", "items": { "type": "integer" }, "description": "Workers compensation codes", "example": [ 3507, 3515, 3548, 3559 ] }, "primary_sic": { "$ref": "#/components/schemas/SicCode" }, "secondary_sic": { "$ref": "#/components/schemas/SicCode" }, "fein": { "type": "string", "description": "Federal Employer Identification Number", "example": "942452212" }, "iso": { "type": "array", "items": { "$ref": "#/components/schemas/IsoCode" }, "description": "ISO General Liability codes" } } }, "NaicsVerification": { "type": "object", "properties": { "verified": { "type": "boolean", "description": "Whether NAICS code was verified", "example": true }, "verified_source": { "type": "string", "description": "Source of verification", "example": "linq_cf" } } }, "SicCode": { "type": "object", "properties": { "code": { "type": "integer", "description": "SIC code number", "example": 354199 }, "description": { "type": [ "string", "null" ], "description": "SIC code description", "example": "Plasma process metal cutting machines" } } }, "IsoCode": { "type": "object", "properties": { "iso_code": { "type": "integer", "description": "ISO code number", "example": 56650 }, "description": { "type": "string", "description": "ISO code description", "example": "Machinery or Machinery Parts Mfg.--Construction Mining or Materials Handling Type" } } }, "BusinessMetrics": { "type": "object", "properties": { "revenue": { "type": "string", "description": "Annual revenue estimate", "example": "$49,613,000.00" }, "revenue_code": { "type": "string", "description": "Revenue estimation method", "example": "Estimated figure" }, "employees": { "type": "integer", "description": "Number of employees", "example": 350 }, "employees_code": { "type": "string", "description": "Employee count estimation method", "example": "Estimated figure" } } }, "ProductService": { "type": "object", "properties": { "name": { "type": "string", "description": "Product or service name", "example": "Machine Tools" }, "description": { "type": "string", "description": "Detailed description", "example": "Industrial machinery and equipment for manufacturing processes" } } }, "AdditionalBusinessData": { "type": "object", "description": "Extended business data including financial, legal, and operational details", "properties": { "business_id": { "type": "string", "description": "Business identifier" }, "tradestyle2_name": { "type": [ "string", "null" ] }, "tradestyle3_name": { "type": ["string", "null"] }, "tradestyle_4_name": { "type": ["string", "null"] }, "tradestyle_5_name": { "type": ["string", "null"] }, "disadvantaged_area_8a": { "type": "string", "example": "Not an 8a Company" }, "ase_exchange": { "type": ["string", "null"], "description": "American Stock Exchange ticker" }, "ase_ticker": { "type": ["string", "null"], "description": "ASE stock ticker symbol" }, "bankruptcy_action": { "type": [ "string", "null" ], "example": "VOLUNTARY" }, "bankruptcy_chapter": { "type": [ "integer", "null" ], "example": 11 }, "bankruptcy_date": { "type": [ "integer", "null" ], "description": "Bankruptcy date (YYYYMMDD)", "example": 20011120 }, "bankruptcy_indicator": { "type": [ "string", "null" ], "example": "Company has Bankruptcy" }, "bankruptcy_status": { "type": [ "string", "null" ], "example": "CLOSE" }, "financial_strength_decile": { "type": "string", "example": "B1" }, "financial_momentum": { "type": "integer", "example": 5 }, "financial_strength_confidence": { "type": "integer", "example": 4 }, "financial_strength": { "type": "integer", "example": 75 }, "business_name_long": { "type": ["string", "null"], "description": "Long form business name" }, "payroll": { "type": "integer", "description": "Annual payroll", "example": 17481300 }, "payroll_confidence": { "type": "integer", "example": 4 }, "vehicle_intensity": { "type": ["string", "null"], "description": "Vehicle intensity code", "example": "C" }, "vehicle_intensity_description": { "type": ["string", "null"], "description": "Vehicle intensity description (Core, Heavy, Incidental, etc.)", "example": "Core" }, "employee_location_code": { "type": ["string", "null"], "description": "Employee count estimation method", "example": "Estimated range" }, "congressional_district_code": { "type": ["string", "null"], "description": "Congressional district code", "example": "03D" }, "cottage_indicator": { "type": ["string", "null"], "description": "Cottage industry indicator (Y/N)", "example": "Y" }, "derived_data_update_date": { "type": ["integer", "null"], "description": "Derived data update date (YYYYMMDD)", "example": 20241017 }, "derived_data_update_time": { "type": ["integer", "null"], "description": "Derived data update time (HHMMSS)", "example": 133838 }, "dsf_mailing_location": { "type": ["string", "null"], "description": "DSF mailing location classification" }, "dsf_physical_location": { "type": ["string", "null"], "description": "DSF physical location classification", "example": "Consumer Location" }, "employees_at_location": { "type": "integer", "example": 266 }, "estimated_number_of_pcs": { "type": "integer", "description": "Estimated number of personal computers", "example": 90 }, "fips_county_code": { "type": ["integer", "null"], "description": "FIPS county code", "example": 81 }, "fips_state_code": { "type": ["integer", "null"], "description": "FIPS state code", "example": 1 }, "fortune1000_indicator": { "type": "string", "example": "N" }, "fortune1000_ranking": { "type": "integer", "example": 0 }, "franchise_code_1": { "type": ["integer", "null"], "description": "First franchise code", "example": 0 }, "franchise_code_2": { "type": ["integer", "null"], "description": "Second franchise code", "example": 0 }, "franchise_indicator": { "type": ["string", "null"], "description": "Franchise indicator" }, "hierarchy_code": { "type": "integer", "example": 5 }, "import_export_indicator": { "type": "string", "example": "Both" }, "it_expenditures_code": { "type": ["string", "null"], "description": "IT expenditures classification", "example": "Top 6% of IT Spenders" }, "legal_status_code": { "type": "string", "example": "Corporation" }, "mailing_address": { "type": ["string", "null"], "description": "Mailing street address" }, "mailing_city_name": { "type": ["string", "null"], "description": "Mailing city" }, "mailing_location_code": { "type": ["string", "null"], "description": "Mailing location code" }, "mailing_state": { "type": ["string", "null"], "description": "Mailing state" }, "mailing_zip_plus4": { "type": ["string", "null"], "description": "Mailing ZIP+4" }, "mailing_zip_code": { "type": ["string", "null"], "description": "Mailing ZIP code" }, "manufacturing_indicator": { "type": "string", "example": "Manufacturing Is Done Here" }, "minority_owned_indicator": { "type": ["string", "null"], "description": "Minority owned business indicator", "example": "Not Minority Owned" }, "minority_type": { "type": ["string", "null"], "description": "Type of minority ownership", "example": "N/A" }, "naics_1_description": { "type": ["string", "null"], "description": "Primary NAICS description", "example": "General Freight Trucking, Local" }, "naics_2_description": { "type": ["string", "null"], "description": "Secondary NAICS description" }, "nas_exchange": { "type": ["string", "null"], "description": "NASDAQ exchange ticker" }, "nas_ticker": { "type": ["string", "null"], "description": "NASDAQ ticker symbol" }, "nms_exchange": { "type": ["string", "null"], "description": "NMS exchange ticker" }, "nms_ticker": { "type": ["string", "null"], "description": "NMS ticker symbol" }, "non_profit_indicator": { "type": "string", "example": "Not a Non Profit" }, "number_of_accounts": { "type": ["integer", "null"], "description": "Number of accounts/customers", "example": 0 }, "nys_exchange": { "type": ["string", "null"], "description": "NYSE exchange ticker" }, "nys_ticker": { "type": ["string", "null"], "description": "NYSE ticker symbol" }, "otc_exchange": { "type": ["string", "null"], "description": "OTC exchange ticker" }, "otc_ticker": { "type": ["string", "null"], "description": "OTC ticker symbol" }, "owns_rents_indicator": { "type": ["string", "null"], "description": "Owns or rents facility", "example": "Rents" }, "parent_headq_city": { "type": ["string", "null"], "description": "Parent company headquarters city" }, "parent_headq_state": { "type": ["string", "null"], "description": "Parent company headquarters state" }, "physical_location_code": { "type": ["string", "null"], "description": "Physical location classification", "example": "Resident address" }, "physical_zip": { "type": ["string", "null"], "description": "Physical ZIP code (9-digit)", "example": "36870855" }, "population_code": { "type": ["string", "null"], "description": "Population range for area", "example": "100,000 To 249,999" }, "public_filing_ind": { "type": ["string", "null"], "description": "Public filing indicator (suits, liens, judgments, bankruptcy)", "example": "Does not have an open Suit, Lien, Judgement or Bankruptcy" }, "public_private_indicator": { "type": "string", "example": "Private" }, "redirect_2_indicator": { "type": ["string", "null"], "description": "Redirect indicator" }, "report_date": { "type": ["integer", "null"], "description": "Report date (YYMMDD format)", "example": 240722 }, "small_indicator": { "type": ["string", "null"], "description": "Small business indicator", "example": "Yes" }, "state_of_incorporation": { "type": ["string", "null"], "description": "State where business is incorporated" }, "status_indicator": { "type": ["string", "null"], "description": "Business status", "example": "Single Location" }, "street_exchange": { "type": ["string", "null"], "description": "Street exchange ticker" }, "street_ticker": { "type": ["string", "null"], "description": "Street ticker symbol" }, "subsidiary_indicator": { "type": "string", "example": "Not a Subsidiary" }, "territory_covered": { "type": ["string", "null"], "description": "Territory coverage", "example": "N/A" }, "url_2": { "type": ["string", "null"], "description": "Secondary URL" }, "url_2_match_type": { "type": ["string", "null"], "description": "Secondary URL match type" }, "url_2_status_indicator": { "type": ["string", "null"], "description": "Secondary URL status" }, "veteran_indicator": { "type": ["string", "null"], "description": "Veteran-owned business indicator" }, "women_owned_indicator": { "type": ["string", "null"], "description": "Women-owned business indicator" }, "year_of_present_control": { "type": "integer", "example": 2002 }, "zip_plus4_extension": { "type": ["string", "null"], "description": "ZIP+4 extension", "example": "8554" }, "upload_time": { "type": "string", "format": "date-time" } } }, "PropertyAttributesObject": { "type": "object", "description": "Property details including assessment, valuation, and mortgage information", "properties": { "lat": { "type": "number", "description": "Latitude", "example": 43.63242 }, "lng": { "type": "number", "description": "Longitude", "example": -72.31138 }, "property": { "$ref": "#/components/schemas/PropertyDetails" }, "valuation": { "$ref": "#/components/schemas/PropertyValuation" }, "assessment": { "$ref": "#/components/schemas/PropertyAssessment" }, "mortgage_info": { "$ref": "#/components/schemas/MortgageInfo" }, "listing_record": { "type": [ "object", "null" ] }, "mls_listing_record_details": { "type": [ "object", "null" ] } } }, "PropertyDetails": { "type": "object", "properties": { "apn": { "type": "string", "description": "Assessor's Parcel Number", "example": "LBAN M:115 B:13 L:" }, "zip": { "type": "string", "example": "03784" }, "owner": { "type": "string", "example": "BENNING ST LLC" }, "address": { "type": "string", "example": "82 BENNING ST, WEST LEBANON, NH 03784" }, "use_code": { "type": "string", "description": "Property use classification", "example": "Light Industrial" }, "street_address": { "type": "string", "example": "82 BENNING ST" } } }, "PropertyValuation": { "type": "object", "properties": { "price_range_max": { "type": "integer", "example": 22525904 }, "price_range_min": { "type": "integer", "example": 12228348 } } }, "PropertyAssessment": { "type": "object", "description": "Property assessment details from tax records", "properties": { "pool": { "type": [ "string", "null" ] }, "heating": { "type": [ "string", "null" ], "example": "Space/Suspended" }, "basement": { "type": [ "string", "null" ] }, "roof_type": { "type": [ "string", "null" ], "example": "GABLE" }, "roof_cover": { "type": [ "string", "null" ], "example": "Metal" }, "tax_amount": { "type": "integer", "example": 199794 }, "year_built": { "type": "string", "example": "1965" }, "garage_cars": { "type": "integer", "example": 0 }, "garage_type": { "type": [ "string", "null" ], "example": "Paved/Surfaced" }, "lsale_price": { "type": "string", "description": "Last sale price", "example": "6700000" }, "lvalid_price": { "type": "string", "example": "6700000" }, "building_area": { "type": "integer", "example": 163990 }, "lotsize_acres": { "type": "number", "example": 10.19 }, "no_of_stories": { "type": "string", "example": "1" }, "building_class": { "type": [ "string", "null" ] }, "assessment_year": { "type": "string", "example": "2024" }, "no_of_buildings": { "type": "integer", "example": 1 }, "number_of_baths": { "type": "integer", "example": 0 }, "number_of_units": { "type": "integer", "example": 1 }, "tax_marketvalue": { "type": "integer", "example": 7602500 }, "building_quality": { "type": [ "string", "null" ] }, "type_construction": { "type": "string", "example": "Steel" }, "building_condition": { "type": "string", "example": "Average" }, "current_owner_name": { "type": "string", "example": "BENNING ST LLC" }, "number_of_bedrooms": { "type": "integer", "example": 0 }, "assessed_land_value": { "type": "integer", "example": 2690100 }, "lotsize_square_feet": { "type": "integer", "example": 443876 }, "total_assessed_value": { "type": "integer", "example": 7602500 }, "assessed_improvement_value": { "type": "integer", "example": 4912400 }, "standardized_land_use_code": { "type": "string", "example": "Manufacturing (light)" } } }, "MortgageInfo": { "type": "object", "properties": { "mtg01_loan_type": { "type": "string", "example": "Commercial" }, "mtg01_loan_amount": { "type": "string", "example": "5600000" }, "mtg01_curr_est_bal": { "type": "string", "example": "5600000" }, "total_open_lien_balance": { "type": "string", "example": "5600000" }, "current_est_ltv_combined": { "type": "string", "example": "32.6291" }, "mtg01_lender_name_beneficiary": { "type": [ "string", "null" ], "example": "FIRST INDUS LP" } } }, "PropertyRiskObject": { "type": "object", "description": "Comprehensive property risk analysis including natural hazards, crime, and environmental factors", "properties": { "lat": { "type": "number", "example": 43.63242 }, "lng": { "type": "number", "example": -72.31138 }, "address": { "type": "string", "example": "82 Benning St, West Lebanon, NH, 03784-3405" }, "match_type": { "type": "string", "example": "rooftop" }, "match_level": { "type": "string", "example": "houseNumber" }, "match_score": { "type": "number", "example": 1 }, "crime": { "$ref": "#/components/schemas/RiskScore" }, "wildfire": { "$ref": "#/components/schemas/RiskScore" }, "earthquake": { "$ref": "#/components/schemas/EarthquakeRisk" }, "flood": { "$ref": "#/components/schemas/RiskScore" }, "hail": { "$ref": "#/components/schemas/EnhancedHailParams" }, "tornado": { "$ref": "#/components/schemas/EnhancedTornadoParams" }, "hurricane": { "$ref": "#/components/schemas/EnhancedHurricaneParams" }, "lightning": { "$ref": "#/components/schemas/EnhancedLightningParams" }, "wind_region": { "$ref": "#/components/schemas/WindRegionRisk" }, "drought": { "$ref": "#/components/schemas/RiskScore" }, "landslide": { "$ref": "#/components/schemas/RiskScore" }, "sinkhole": { "$ref": "#/components/schemas/SinkholeRisk" }, "radon": { "$ref": "#/components/schemas/RiskScore" }, "pfa": { "$ref": "#/components/schemas/PfaRisk" }, "ust": { "$ref": "#/components/schemas/RiskScore" }, "superfund": { "$ref": "#/components/schemas/SuperfundRisk" }, "brownfield": { "$ref": "#/components/schemas/BrownfieldRisk" }, "fire_protection": { "$ref": "#/components/schemas/FireProtectionRisk" }, "hydrant": { "$ref": "#/components/schemas/RiskScore" }, "hospital": { "$ref": "#/components/schemas/HospitalInfo" }, "police_stations": { "$ref": "#/components/schemas/PoliceStationInfo" }, "fema_all_flood": { "$ref": "#/components/schemas/RiskScore" }, "fema_firm_date": { "$ref": "#/components/schemas/FemaFirmInfo" }, "fema_firm_panels": { "$ref": "#/components/schemas/FemaFirmPanels" }, "fema_claims": { "type": "object", "description": "FEMA claims by year" }, "fema_bcat": { "$ref": "#/components/schemas/FemaBcatInfo" }, "census_block": { "$ref": "#/components/schemas/CensusBlockInfo" }, "state_county": { "$ref": "#/components/schemas/StateCountyInfo" }, "weather_params": { "$ref": "#/components/schemas/WeatherParams" }, "enhanced_wildfire": { "$ref": "#/components/schemas/EnhancedWildfireRisk" }, "enhanced_hazardhub_flood": { "$ref": "#/components/schemas/RiskScore" }, "hazardhub_catastrophic_flood": { "$ref": "#/components/schemas/RiskScore" }, "ground_snow_load": { "$ref": "#/components/schemas/SnowLoadRisk" }, "hh_snow_load": { "$ref": "#/components/schemas/SnowLoadRisk" }, "ice_dam_index": { "$ref": "#/components/schemas/IndexRisk" }, "frozen_pipe_index": { "$ref": "#/components/schemas/IndexRisk" }, "mold_index": { "$ref": "#/components/schemas/IndexRisk" }, "hardiness": { "$ref": "#/components/schemas/Hardiness" }, "potential_maximum_precipitation": { "type": "string", "description": "Maximum 24 hour rainfall in inches", "example": "25.91 Inches" }, "enhanced_hazardhub_flood_params": { "$ref": "#/components/schemas/EnhancedHazardhubFloodParams" }, "potential_catastrophic_precipitation": { "type": "string", "description": "Maximum catastrophic 24 hour rainfall in inches", "example": "51.82 Inches" }, "hazardhub_catastrophic_flood_params": { "$ref": "#/components/schemas/HazardhubCatastrophicFloodParams" }, "fema_all_flood_params": { "$ref": "#/components/schemas/FemaAllFloodParams" }, "distance_to_significant_flood_params": { "$ref": "#/components/schemas/DistanceToSignificantFloodParams" }, "base_flood_elevation": { "$ref": "#/components/schemas/BaseFloodElevation" }, "fema_map_params": { "$ref": "#/components/schemas/FemaMapParams" }, "hail_ring_params": { "$ref": "#/components/schemas/HailRingParams" }, "tornado_ring_params": { "$ref": "#/components/schemas/TornadoRingParams" }, "wind_ring_params": { "$ref": "#/components/schemas/WindRingParams" }, "convection_storm": { "$ref": "#/components/schemas/ConvectionStorm" }, "convection_storm_per_decade": { "$ref": "#/components/schemas/ConvectionStormPerDecade" }, "hh_elevation": { "$ref": "#/components/schemas/HhElevation" }, "aspect_risk": { "$ref": "#/components/schemas/AspectRisk" }, "slope_risk": { "$ref": "#/components/schemas/SlopeRisk" }, "murder": { "$ref": "#/components/schemas/CrimeDetail" }, "forcible_rape": { "$ref": "#/components/schemas/CrimeDetail" }, "forcible_robbery": { "$ref": "#/components/schemas/CrimeDetail" }, "aggravated_assault": { "$ref": "#/components/schemas/CrimeDetail" }, "burglary": { "$ref": "#/components/schemas/CrimeDetail" }, "larceny": { "$ref": "#/components/schemas/CrimeDetail" }, "motor_vehicle_theft": { "$ref": "#/components/schemas/CrimeDetail" }, "enhanced_wind_params": { "$ref": "#/components/schemas/EnhancedWindParams" } } }, "RiskScore": { "type": "object", "properties": { "text": { "type": [ "string", "null" ], "description": "Human-readable risk description" }, "score": { "type": [ "string", "null" ], "description": "Risk grade (A-F)", "example": "B" }, "value": { "type": [ "integer", "null" ], "description": "Numeric risk value" } } }, "EarthquakeRisk": { "type": "object", "properties": { "mmi": { "type": "string", "description": "Modified Mercalli Intensity", "example": "VI" }, "text": { "type": "string", "example": "Light Damage" }, "score": { "type": "string", "example": "B" }, "shake": { "type": "string", "example": "Strong" }, "richter_scale": { "type": "string", "example": "4.1-4.6" }, "peak_ground_acceleration": { "type": "integer", "example": 12 } } }, "EnhancedHailParams": { "type": "object", "properties": { "text": { "type": "string", "description": "Text-based description of hail risk level", "example": "Moderate" }, "scale": { "type": "integer", "description": "Numeric scale 0-46+, 0 = lowest risk", "example": 37 }, "score": { "type": "string", "description": "Letter grade A-F, A = lowest risk", "example": "C" }, "historical_hail_events": { "type": "object", "properties": { "hail_rad": { "type": "string", "description": "Likelihood of damaging hail in 10-year period within radius", "example": "95% chance of damaging hail occurrence in 10 years in a 2.5 mile radius" } } }, "num_of_damaging_hail_incidents_within_25_miles_since_1996": { "type": "integer", "description": "Number of damaging hail incidents within 25 miles since 1996", "example": 259 }, "num_of_damaging_hail_incidents_within_25_miles_last_23_years": { "type": "integer", "description": "Number of damaging hail incidents within 25 miles in past 23 years", "example": 259 }, "count_within_25_miles_for_last_decade": { "type": "integer", "description": "Count of hail events within 25 miles in last decade", "example": 100 }, "nearest_hail_incident": { "$ref": "#/components/schemas/WeatherIncident" }, "haddrisk": { "type": "number", "description": "Annual probability of damaging hail at address", "example": 0.05743 }, "hpctrisk": { "type": "string", "description": "Percentage probability of damaging hail at address", "example": "5.743%" } } }, "EnhancedTornadoParams": { "type": "object", "description": "Enhanced tornado risk analysis within 25-mile radius", "properties": { "text": { "type": "string", "description": "Text-based tornado risk level", "example": "Moderate" }, "scale": { "type": "integer", "description": "Numeric scale 0-30+, 0 = lowest risk", "example": 41 }, "score": { "type": "string", "description": "Letter grade A-F", "example": "C" }, "historical_tornado_events": { "type": "object", "properties": { "tornado_rad": { "type": "string", "description": "Likelihood of tornado in 10-year period within radius", "example": "50% chance of damaging tornado occurrence in 10 years in a 4.0 mile radius" } } }, "num_of_damaging_tornado_incidents_within_25_miles_since_1996": { "type": "integer", "example": 78 }, "num_of_damaging_tornado_incidents_within_25_miles_last_23_years": { "type": "integer", "description": "Tornado incidents in past 23 years", "example": 78 }, "count_within_25_miles_for_last_decade": { "type": "integer", "description": "Tornado events in last decade", "example": 39 }, "nearest_tornado_incident": { "$ref": "#/components/schemas/WeatherIncident" }, "taddrisk": { "type": "number", "description": "Annual probability of tornado at address", "example": 0.017296 }, "tpctrisk": { "type": "string", "description": "Percentage probability of tornado at address", "example": "1.7296%" } } }, "EnhancedHurricaneParams": { "type": "object", "properties": { "text": { "type": "string", "example": "Low Property Damage" }, "scale": { "type": "number", "example": 4.5 }, "score": { "type": "string", "example": "B" }, "num_hurricanes": { "type": "integer", "example": 1 }, "num_tropical_storms": { "type": "integer", "example": 4 }, "avg_wind_speed_knots": { "type": "integer", "example": 35 }, "max_wind_speed_knots": { "type": "integer", "example": 62 }, "total_events_since1980": { "type": "integer", "example": 19 } } }, "EnhancedLightningParams": { "type": "object", "properties": { "text": { "type": "string", "example": "Low" }, "scale": { "type": "integer", "example": 36 }, "score": { "type": "string", "example": "B" }, "lsqmi": { "type": "string", "example": "95% chance of 1.742994 ground strikes in 1 year per square mile" }, "laddrisk": { "type": "number", "example": 0.00272 }, "lpctrisk": { "type": "string", "example": "0.27234%" } } }, "WeatherIncident": { "type": "object", "description": "Historical weather incident details (hail, tornado, or wind event)", "properties": { "type": { "type": "string", "description": "Type of weather event", "example": "Hail" }, "year": { "type": "string", "description": "Year of incident", "example": "2014" }, "deaths": { "type": "string", "description": "Number of reported deaths", "example": "0" }, "injuries": { "type": "string", "description": "Number of reported injuries", "example": "0" }, "prop_dam": { "type": ["string", "null"], "description": "Property damage estimate", "example": "0.00K" }, "crop_dam": { "type": ["string", "null"], "description": "Crop damage estimate", "example": "0.00K" }, "inches": { "type": ["string", "null"], "description": "Hail size in inches (for hail events)", "example": "1.0" }, "fscale": { "type": ["string", "null"], "description": "Fujita scale (for tornado events): F0-F4, EF0-EF5", "example": "F0" }, "wind_spd": { "type": ["string", "null"], "description": "Wind speed in MPH (for wind events)", "example": "52.0" }, "distance_miles": { "type": "number", "description": "Distance to incident in miles", "example": 1.29 } } }, "WindRegionRisk": { "type": "object", "properties": { "text": { "type": "string", "example": "HazardHub Hurricane Prone Wind Region: Risk varies with location" }, "score": { "type": "string", "example": "F" }, "text2": { "type": "string", "example": "Strong seasonal wind risks: New England Katabatic Special Wind Region" } } }, "SinkholeRisk": { "type": "object", "properties": { "text": { "type": [ "string", "null" ] }, "score": { "type": [ "string", "null" ] }, "distance": { "type": "object", "properties": { "units": { "type": [ "string", "null" ] }, "value": { "type": [ "number", "null" ] } } } } }, "PfaRisk": { "type": "object", "properties": { "text": { "type": "string", "example": "3004 feet from known PFA Site" }, "type": { "type": "string", "example": "Waste Water Treatment" }, "score": { "type": "string", "example": "C" }, "site_name": { "type": "string", "example": "Lebanon Wastewater Treatment Facility- Influent" } } }, "SuperfundRisk": { "type": "object", "properties": { "text": { "type": [ "string", "null" ] }, "score": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "site_name": { "type": [ "string", "null" ] }, "registry_number": { "type": [ "string", "null" ] } } }, "BrownfieldRisk": { "type": "object", "properties": { "text": { "type": [ "string", "null" ] }, "score": { "type": [ "string", "null" ] }, "address": { "type": [ "string", "null" ] }, "site_name": { "type": [ "string", "null" ] }, "registry_number": { "type": [ "string", "null" ] } } }, "FireProtectionRisk": { "type": "object", "properties": { "text": { "type": "string", "example": "Within Municipality & > 1 & <= 2 Drive Miles from Fire Station" }, "score": { "type": "string", "example": "B" }, "aais_proxy": { "type": "string", "example": "P2" } } }, "HospitalInfo": { "type": "object", "properties": { "name": { "type": "string", "example": "ALICE PECK DAY MEMORIAL HOSPITAL" }, "type": { "type": "string", "example": "CRITICAL ACCESS" }, "state": { "type": "string", "example": "NH" }, "address": { "type": "string", "example": "10 ALICE PECK DAY DRIVE" }, "helipad": { "type": "string", "example": "No" }, "distance": { "type": "string", "example": "1.33 miles" }, "number_of_hospitals_within5_miles": { "type": "integer", "example": 3 }, "number_of_hospitals_within10_miles": { "type": "integer", "example": 3 } } }, "PoliceStationInfo": { "type": "object", "properties": { "name": { "type": "string", "example": "LEBANON POLICE DEPARTMENT" }, "distance": { "type": "string", "example": "1.02 miles" }, "number_within5_miles": { "type": "integer", "example": 2 } } }, "FemaFirmInfo": { "type": "object", "properties": { "cid": { "type": "string", "example": "330061" }, "name": { "type": "string", "description": "FIRM place name", "example": "HARRIS COUNTY" }, "type": { "type": ["string", "null"], "description": "FIRM place type", "example": "COUNTY OF" }, "initial_flood_hazard_bounday_map_id_date": { "type": ["string", "null"], "description": "Initial hazard boundary map ID date", "example": "05/26/1970" }, "initial_firm_id_date": { "type": ["string", "null"], "description": "Initial FIRM ID date", "example": "05/26/1970" }, "current_effective_date_flood_map": { "type": ["string", "null"], "description": "Current effective date for flood map", "example": "11/15/2019" }, "date_entered_program": { "type": ["string", "null"], "description": "Date community entered NFIP program", "example": "05/26/1970" }, "community_name": { "type": ["string", "null"], "description": "Name of participating community", "example": "HARRIS COUNTY" }, "crs_entry_date": { "type": ["string", "null"], "description": "Community Rating System entry date", "example": "05/01/2004" }, "current_effective_date": { "type": ["string", "null"], "description": "Current effective date for CRS", "example": "10/01/2014" }, "current_class": { "type": ["string", "null"], "description": "Current CRS class (1-10)", "example": "7" }, "percent_discount_for_sfha": { "type": ["string", "null"], "description": "NFIP discount percentage for Special Flood Hazard Area", "example": "15" }, "percent_discount_for_non_sfha": { "type": ["string", "null"], "description": "NFIP discount percentage for non-SFHA" }, "status": { "type": ["string", "null"], "description": "FEMA status code" } } }, "FemaFirmPanels": { "type": "object", "properties": { "firm_panel": { "type": "string", "example": "33009C0893E" }, "effective_date": { "type": "string", "example": "2008/20/02" } } }, "FemaBcatInfo": { "type": "object", "description": "FEMA Building Code Adoption Tracking - hazard resistance and risk indicators", "properties": { "combined_hazard": { "type": ["string", "null"], "description": "Overall hazard resistance classification", "example": "Partially Resistant" }, "flood_resistance": { "type": ["string", "null"], "description": "Flood resistance based on building code adoption", "example": "Partially Resistant" }, "hurricane_resistance": { "type": ["string", "null"], "description": "Hurricane resistance based on building code adoption", "example": "Partially Resistant" }, "seismic_resistance": { "type": ["string", "null"], "description": "Seismic resistance based on building code adoption" }, "tornado_resistance": { "type": ["string", "null"], "description": "Tornado resistance based on building code adoption" }, "wind_resistance": { "type": ["string", "null"], "description": "Wind resistance based on building code adoption" }, "flood_risk": { "type": "string", "description": "Binary flag indicating flood hazard exposure", "example": "Yes" }, "hurricane_risk": { "type": "string", "description": "Binary flag indicating hurricane hazard exposure", "example": "Yes" }, "seismic_risk": { "type": "string", "description": "Binary flag indicating seismic hazard exposure", "example": "No" }, "tornado_risk": { "type": "string", "description": "Binary flag indicating tornado hazard exposure", "example": "No" }, "wind_risk": { "type": "string", "description": "Binary flag indicating wind hazard exposure", "example": "No" } } }, "CensusBlockInfo": { "type": "object", "properties": { "block": { "type": "string", "example": "5027" }, "geoid": { "type": "string", "example": "330099617005027" }, "tract": { "type": "string", "example": "961700" }, "block_group": { "type": "string", "example": "330099617005" }, "state_fips_code": { "type": "string", "example": "33" }, "county_fips_code": { "type": "string", "example": "009" } } }, "StateCountyInfo": { "type": "object", "properties": { "state": { "type": "string", "example": "New Hampshire" }, "jurisdiction": { "type": "string", "example": "Grafton County" }, "state_and_county_fips_code": { "type": "string", "example": "33009" } } }, "WeatherParams": { "type": "object", "description": "Comprehensive historical weather statistics - 30-year climate normals", "properties": { "annual_average_days_less_than_0": {"type": "string", "description": "Days < 0°F", "example": "0.0 Days"}, "annual_average_days_less_than_10": {"type": "string", "description": "Days < 10°F", "example": "0.0 Days"}, "annual_average_days_less_than_20": {"type": "string", "description": "Days < 20°F", "example": "0.0 Days"}, "annual_average_days_more_than_40": {"type": "string", "description": "Days > 40°F", "example": "364.3 Days"}, "annual_average_days_more_than_50": {"type": "string", "description": "Days > 50°F", "example": "356.8 Days"}, "annual_fall_days_less_than_0": {"type": "string", "description": "Fall days < 0°F", "example": "0.0 Days"}, "annual_fall_days_less_than_10": {"type": "string", "description": "Fall days < 10°F", "example": "0.0 Days"}, "annual_fall_days_less_than_20": {"type": "string", "description": "Fall days < 20°F", "example": "0.0 Days"}, "annual_fall_days_less_than_32": {"type": "string", "description": "Fall days < 32°F", "example": "0.3 Days"}, "annual_spring_days_less_than_0": {"type": "string", "description": "Spring days < 0°F", "example": "0.0 Days"}, "annual_spring_days_less_than_10": {"type": "string", "description": "Spring days < 10°F", "example": "0.0 Days"}, "annual_spring_days_less_than_20": {"type": "string", "description": "Spring days < 20°F", "example": "0.0 Days"}, "annual_spring_days_less_than_32": {"type": "string", "description": "Spring days < 32°F", "example": "0.3 Days"}, "annual_winter_days_less_than_0": {"type": "string", "description": "Winter days < 0°F", "example": "0.0 Days"}, "annual_winter_days_less_than_10": {"type": "string", "description": "Winter days < 10°F", "example": "0.0 Days"}, "annual_winter_days_less_than_20": {"type": "string", "description": "Winter days < 20°F", "example": "0.0 Days"}, "annual_winter_days_less_than_40": {"type": "string", "description": "Winter days < 40°F", "example": "25.9 Days"}, "average_annual_precipitation": {"type": "string", "description": "Annual precipitation", "example": "54.12 Inches"}, "average_annual_temperature_max": {"type": "string", "description": "Annual high temperature", "example": "79.6 Degrees F"}, "average_annual_temperature_min": {"type": "string", "description": "Annual low temperature", "example": "61.5 Degrees F"}, "avg_num_days_below_32_degrees": {"type": "string", "description": "Annual days < 32°F", "example": "0.0 Days"}, "avg_num_winter_days_below_32_degrees": {"type": "string", "description": "Winter days < 32°F min temp", "example": "4.2 Days"}, "cooling_degree_days": {"type": "string", "description": "Degrees exceeding 65°F annually", "example": "3280.0 Degrees F"}, "fall_diurnal_range": {"type": "string", "description": "Fall temperature range", "example": "18.7 Degrees F"}, "fall_days_with_max_temp_less_than_32": {"type": "string", "description": "Fall days max < 32°F", "example": "0.0 Days"}, "heating_degree_days": {"type": "string", "description": "Degrees below 65°F annually", "example": "1222.0 Degrees F"}, "spring_days_with_max_temp_less_than_32": {"type": "string", "description": "Spring days max < 32°F", "example": "0.0 Days"}, "spring_diurnal_range": {"type": "string", "description": "Spring temperature range", "example": "18.3 Degrees F"}, "winter_days_with_max_temp_less_than_32": {"type": "string", "description": "Winter days max < 32°F", "example": "0.0 Days"}, "winter_diurnal_range": {"type": "string", "description": "Winter temperature range", "example": "18.5 Degrees F"}, "average_annual_snowfall": {"type": "string", "description": "Annual snowfall", "example": "0.0 Inches"}, "average_days_snowfall_greater_than_10_inches": {"type": "string", "description": "Days snowfall > 10 inches", "example": "0.0 Days"}, "average_days_snowfall_greater_than_1_inch": {"type": "string", "description": "Days snowfall > 1 inch", "example": "0.0 Days"}, "average_fall_snowfall": {"type": "string", "description": "Fall snowfall", "example": "0.0 Inches"}, "average_spring_snowfall": {"type": "string", "description": "Spring snowfall", "example": "0.0 Inches"}, "average_winter_snowfall": {"type": "string", "description": "Winter snowfall", "example": "0.0 Inches"}, "avg_days_snow_depth_above_10_in": {"type": "string", "description": "Days snow depth > 10 inches", "example": "0.0 Days"}, "avg_days_snow_depth_above_1_in": {"type": "string", "description": "Days snow depth > 1 inch", "example": "0.0 Days"}, "avg_days_snowfall_above_1_in": {"type": "string", "description": "Days snowfall > 1 inch", "example": "0.0 Days"}, "fall_days_snow_depth_greater_than_10_inches": {"type": "string", "example": "0.0 Days"}, "fall_days_snow_depth_greater_than_1_inch": {"type": "string", "example": "0.0 Days"}, "fall_days_snow_depth_greater_than_3_inches": {"type": "string", "example": "0.0 Days"}, "fall_days_snow_depth_greater_than_5_inches": {"type": "string", "example": "0.0 Days"}, "spring_days_snow_depth_greater_than_10_inches": {"type": "string", "example": "0.0 Days"}, "spring_days_snow_depth_greater_than_1_inch": {"type": "string", "example": "0.0 Days"}, "spring_days_snow_depth_greater_than_3_inches": {"type": "string", "example": "0.0 Days"}, "spring_days_snow_depth_greater_than_5_inches": {"type": "string", "example": "0.0 Days"}, "winter_days_snow_depth_greater_than_10_inches": {"type": "string", "example": "0.0 Days"}, "winter_days_snow_depth_greater_than_1_inch": {"type": "string", "example": "0.0 Days"}, "winter_days_snow_depth_greater_than_3_inches": {"type": "string", "example": "0.0 Days"}, "winter_days_snow_depth_greater_than_5_inches": {"type": "string", "example": "0.0 Days"} } }, "EnhancedWildfireRisk": { "type": "object", "properties": { "text": { "type": "string", "example": "Low" }, "score": { "type": "string", "example": "B" }, "risk_scores": { "type": "object", "properties": { "base": { "type": "integer" }, "composite": { "type": "integer" } } }, "landcover_risk": { "$ref": "#/components/schemas/LandcoverRisk" } } }, "LandcoverRisk": { "type": "object", "properties": { "desc": { "type": "string", "example": "Distance to significant wildfire fuel load risk" }, "score": { "type": "integer", "example": 9 }, "detail": { "type": "object", "properties": { "area_desc": { "type": "string" }, "site_desc": { "type": "string" } } } } }, "SnowLoadRisk": { "type": "object", "properties": { "desc": { "type": "string", "example": "Highly likely to have roof failure if winter snowfall well above normal" }, "text": { "type": "string", "example": "Very High" }, "scale": { "type": "integer", "example": 18 }, "score": { "type": "string", "example": "F" } } }, "IndexRisk": { "type": "object", "properties": { "text": { "type": "string", "example": "Very High" }, "index": { "type": "number", "example": 312.1 }, "score": { "type": "string", "example": "F" } } }, "ReplacementCostObject": { "type": "object", "description": "Property replacement cost analysis", "properties": { "pool": { "type": [ "string", "null" ] }, "use_code": { "type": "string", "example": "Light Industrial" }, "fireplace": { "type": [ "string", "null" ] }, "year_built": { "type": "string", "example": "1965" }, "garage_type": { "type": [ "string", "null" ], "example": "Paved/Surfaced" }, "no_of_stories": { "type": "string", "example": "1" }, "number_of_baths": { "type": "integer", "example": 0 }, "square_footage": { "type": "integer", "example": 163990 }, "zipcode_factor": { "type": "number", "example": 0.906228 }, "demolition_cost": { "type": "number", "description": "Estimated demolition cost", "example": 2724133.67 }, "building_quality": { "type": [ "string", "null" ] }, "calculation_date": { "type": "string", "format": "date-time", "example": "2025-10-10T16:18:41.884Z" }, "replacement_cost": { "type": "number", "description": "Total building replacement cost", "example": 27241336.66 }, "contents_estimate": { "type": "integer", "description": "Estimated contents value", "example": 8172401 }, "type_construction": { "type": "string", "example": "Steel" }, "building_condition": { "type": "string", "example": "Average" }, "debris_removal_cost": { "type": "number", "example": 6810334.16 }, "square_footage_factor": { "type": "number", "example": 1.5 }, "property_use_base_value": { "type": "number", "example": 122.2 }, "building_quality_factor": { "type": "integer", "example": 1 }, "estimated_builder_profit": { "type": "number", "example": 2478961.64 }, "building_condition_factor": { "type": "integer", "example": 1 }, "replacement_cost_persqfeet": { "type": "number", "description": "Cost per square foot", "example": 166.12 } } }, "InsuranceCoverageObject": { "type": "object", "description": "Insurance coverage recommendations organized by priority", "properties": { "recommended": { "type": "array", "items": { "$ref": "#/components/schemas/CoverageRecommendation" }, "description": "Primary recommended coverages" }, "additional": { "type": "array", "items": { "$ref": "#/components/schemas/CoverageRecommendation" }, "description": "Additional coverage options" } } }, "CoverageRecommendation": { "type": "object", "properties": { "coverage_id": { "type": "string", "description": "Unique coverage identifier", "example": "CVG0007" }, "coverage_name": { "type": "string", "description": "Coverage type name", "example": "Environmental Impairment Liability" }, "rank": { "type": "integer", "description": "Priority ranking", "example": 1 }, "score": { "type": "integer", "description": "Relevance score", "example": 40 }, "definition": { "type": "string", "description": "Detailed coverage description and rationale" } } }, "ExposureItem": { "type": "object", "description": "Business exposure analysis", "properties": { "exposure_id": { "type": "string", "example": "EXP0017" }, "exposure_name": { "type": "string", "example": "Equipment Breakdown Exposure" }, "definition": { "type": "string", "description": "Detailed exposure description and risk factors" } } }, "RiskAssessmentItem": { "type": "object", "description": "Detailed risk assessment by exposure category", "properties": { "risk_id": { "type": "string", "example": "RISK03501" }, "exposure_id": { "type": "string", "example": "EXP0017" }, "list_of_risk": { "type": "array", "items": { "$ref": "#/components/schemas/RiskDetail" } } } }, "RiskDetail": { "type": "object", "properties": { "cause_of_loss": { "type": "string", "example": "Production equipment malfunction leading to project delays" }, "magnitude": { "type": "string", "enum": [ "low", "medium", "high", "extreme", "very extreme" ], "example": "high" }, "mitigating_factors": { "type": "array", "items": { "type": "string" }, "description": "Recommended mitigation strategies" } } }, "FmcdObject": { "type": "object", "description": "Enhanced Fleet and Motor Carrier Data from DOT/FMCSA. Organized with DOT-level data (company_info, fleet_info, safety_info) and docket-level data (authorities array, insurance_requirements, current_insurance, previous_insurance). CRITICAL: Insurance data is linked by docket_number.", "properties": { "company_info": { "$ref": "#/components/schemas/FmcdCompanyInfo" }, "fleet_info": { "$ref": "#/components/schemas/FmcdFleetInfo" }, "safety_info": { "$ref": "#/components/schemas/FmcdSafetyInfo" }, "authorities": { "type": ["array", "null"], "description": "Array of authority records per docket number. Each docket has separate authority status.", "items": { "$ref": "#/components/schemas/FmcdAuthorityRecord" } }, "insurance_requirements": { "type": ["array", "null"], "description": "Insurance requirements per docket number. Each record includes docket_number.", "items": { "$ref": "#/components/schemas/InsuranceRequirements" } }, "current_insurance": { "type": ["array", "null"], "description": "Current active insurance policies from dot_insurance_all_with_history. Each record includes docket_number to associate with the authority.", "items": { "$ref": "#/components/schemas/CurrentInsuranceRecord" } }, "previous_insurance": { "type": ["array", "null"], "description": "Previous/historical insurance policies from dot_insurance_hist_all. Each record includes docket_number to associate with the authority.", "items": { "$ref": "#/components/schemas/PreviousInsuranceRecord" } }, "data_source": { "type": "string", "description": "Data source identifier", "example": "linq_osha_dot_wc" } } }, "OshaObject": { "type": "object", "description": "OSHA safety compliance data with establishment information and metrics", "properties": { "establishment_info": { "$ref": "#/components/schemas/EstablishmentInfo" }, "safety_summary": { "type": "array", "items": { "$ref": "#/components/schemas/SafetySummary" }, "description": "Annual safety summary data" }, "case_details": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/CaseDetail" }, "description": "Detailed case information" }, "safety_metrics": { "$ref": "#/components/schemas/SafetyMetrics" }, "data_source": { "type": "string", "description": "Data source identifier", "example": "linq_osha_dot_wc" } } }, "FloodObject": { "type": "object", "description": "Detailed flood risk analysis", "properties": { "success": { "type": "boolean", "example": true }, "status": { "type": "string", "example": "OK" }, "address": { "type": "string", "example": "82 Benning Street, Lebanon, New Hampshire, USA" }, "latitude": { "type": "number", "example": 43.63245 }, "longitude": { "type": "number", "example": -72.31154 }, "unit": { "type": "string", "example": "ft" }, "confidence": { "type": "string", "example": "Medium" }, "basement": { "type": "string", "example": "No" }, "basement_confidence": { "type": "string", "example": "Low" }, "flood_zone": { "type": "string", "description": "FEMA flood zone designation", "example": "AE" }, "awareness": { "type": "string", "example": "very low" }, "financial_resilience_gap": { "type": "string", "example": "medium" }, "annual_nfip_policy": { "type": "string", "example": "medium" }, "flood_hazard": { "type": "string", "example": "low" }, "flood_freq": { "type": "integer", "example": 1 }, "roof_type": { "type": "string", "example": "low slope" }, "rooftop_angle": { "type": "number", "example": 18.15265 }, "precipitation": { "type": "number", "example": 11.84 }, "stories": { "type": "string", "example": "2 or more stories" }, "fld_distance": { "type": "integer", "description": "Distance to flood zone in feet", "example": 236 }, "river_distance": { "type": "integer", "description": "Distance to river in feet", "example": 347 }, "cbrs": { "type": "string", "example": "N/A" }, "ffh": { "type": "string", "description": "First floor height", "example": "0.68" }, "ffh_lowered": { "type": [ "string", "null" ] }, "commercial": { "type": "string", "example": "No" }, "empty_lot": { "type": "string", "example": "No" }, "raised_with_enclosure": { "type": "string", "example": "NA" }, "median_height_of_steps": { "type": "number", "example": 26.55 }, "garage": { "type": "string", "example": "No" }, "coastal_underwriting_guidelines": { "type": "string", "example": "Zone X" }, "distance_to_coast": { "type": "integer", "description": "Distance to coast in feet", "example": 282719 }, "lag": { "type": "string", "description": "Lowest adjacent grade", "example": "363.50" }, "hag": { "type": "string", "description": "Highest adjacent grade", "example": "375.16" }, "elevation": { "type": "number", "example": 371.71 }, "risk_score": { "type": "string", "example": "High" }, "slope": { "type": "string", "example": "Yes" }, "best_strategy10": { "type": "string", "example": "Indemnity Insurance" }, "best_strategy30": { "type": "string", "example": "Indemnity Insurance" } } }, "ErrorResponse": { "type": "object", "properties": { "error": { "type": "string", "description": "Error message", "example": "Invalid authentication credentials" }, "error_code": { "type": "string", "description": "Error code for debugging", "example": "AUTH_001" }, "timestamp": { "type": "string", "format": "date-time", "description": "Error timestamp" } } }, "HttpValidationError": { "type": "object", "properties": { "detail": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationError" } } } }, "ValidationError": { "type": "object", "properties": { "loc": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "description": "Error location", "example": [ "body", "features" ] }, "msg": { "type": "string", "description": "Error message", "example": "field required" }, "type": { "type": "string", "description": "Error type", "example": "value_error.missing" } } }, "BusinessSearchResponse": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/BusinessSearchResult" } }, "count": { "type": "integer", "description": "Total number of results found" }, "query": { "type": "string", "description": "Original search query" } } }, "BusinessSearchResult": { "type": "object", "properties": { "uid": { "type": "string", "description": "Unique business identifier for LinqConnect" }, "bus_name": { "type": "string", "description": "Business name" }, "bus_address": { "type": "string", "description": "Business address" } } }, "EstablishmentInfo": { "type": "object", "description": "OSHA establishment identification and information", "properties": { "establishment_id": { "type": "integer", "description": "OSHA establishment ID", "example": 1322371 }, "establishment_name": { "type": "string", "description": "Establishment name", "example": "Auxiliary Operations Resource" }, "company_name": { "type": "string", "description": "Company name", "example": "Auxiliary Operations Resource" }, "ein": { "type": "string", "description": "Employer Identification Number", "example": "475490174" }, "address": { "$ref": "#/components/schemas/EstablishmentAddress" }, "naics_code": { "type": "integer", "description": "NAICS code", "example": 561910 }, "industry_description": { "type": "string", "description": "Industry description", "example": "Blister packaging services" }, "match_confidence": { "type": "string", "description": "Confidence score for establishment match", "example": "75.0000" }, "match_type": { "type": "string", "description": "Type of matching used", "example": "blocking_small" }, "naics_year": { "type": "integer", "description": "NAICS code year", "example": 2022 } } }, "EstablishmentAddress": { "type": "object", "properties": { "street": { "type": "string", "description": "Street address", "example": "923 Whitaker Rd" }, "city": { "type": "string", "description": "City", "example": "Plainfield" }, "state": { "type": "string", "description": "State abbreviation", "example": "IN" }, "zip_code": { "type": "string", "description": "ZIP code", "example": "46168" } } }, "SafetySummary": { "type": "object", "description": "Annual safety summary from OSHA 300A form", "properties": { "year": { "type": "integer", "description": "Reporting year", "example": 2024 }, "annual_average_employees": { "type": "integer", "description": "Annual average number of employees", "example": 125 }, "total_hours_worked": { "type": "integer", "description": "Total hours worked by all employees", "example": 227934 }, "no_injuries_illnesses": { "type": "integer", "description": "Number of cases with no injuries or illnesses", "example": 1 }, "total_deaths": { "type": "integer", "description": "Total number of deaths", "example": 0 }, "total_dafw_cases": { "type": "integer", "description": "Total Days Away From Work cases", "example": 2 }, "total_djtr_cases": { "type": "integer", "description": "Total Days of Job Transfer or Restriction cases", "example": 0 }, "total_other_cases": { "type": "integer", "description": "Total other recordable cases", "example": 0 }, "total_dafw_days": { "type": "integer", "description": "Total days away from work", "example": 7 }, "total_djtr_days": { "type": "integer", "description": "Total days of job transfer or restriction", "example": 0 }, "breakdown_by_type": { "$ref": "#/components/schemas/InjuryBreakdown" }, "establishment_type": { "type": "integer", "description": "Establishment type code", "example": 1 }, "change_reason": { "type": [ "string", "null" ], "description": "Reason for data change" } } }, "InjuryBreakdown": { "type": "object", "description": "Breakdown of injuries and illnesses by type", "properties": { "injuries": { "type": "integer", "description": "Total injuries", "example": 2 }, "skin_disorders": { "type": "integer", "description": "Skin disorders", "example": 0 }, "respiratory_conditions": { "type": "integer", "description": "Respiratory conditions", "example": 0 }, "poisonings": { "type": "integer", "description": "Poisonings", "example": 0 }, "hearing_loss": { "type": "integer", "description": "Hearing loss cases", "example": 0 }, "other_illnesses": { "type": "integer", "description": "Other illnesses", "example": 0 } } }, "CaseDetail": { "type": "object", "description": "Detailed case information for specific injuries or illnesses (2024+ data)", "properties": { "case_number": { "type": "string", "description": "Case number", "example": "M455196" }, "year_filing_for": { "type": "integer", "description": "Year of filing", "example": 2024 }, "date_of_incident": { "type": "string", "format": "date", "description": "Date of incident", "example": "2024-11-06" }, "incident_outcome": { "type": "integer", "description": "Most serious outcome: 1=Death, 2=Days away, 3=Transfer, 4=Other", "example": 2 }, "days_away_from_work": { "type": "integer", "description": "Number of days away from work", "example": 38 }, "days_job_transfer_restriction": { "type": "integer", "description": "Number of days with job transfer or restriction", "example": 0 }, "type_of_incident": { "type": "integer", "description": "Type of incident code" }, "time_of_incident": { "type": ["string", "null"], "format": "time", "description": "Time incident occurred", "example": "00:00:00" }, "date_of_death": { "type": ["string", "null"], "format": "date", "description": "Date of death if applicable" }, "job_description": { "type": "string", "description": "Employee job title/description", "example": "Equipment Operator I" }, "soc_code": { "type": "string", "description": "2018 Standard Occupation Code (9999=unassigned)", "example": "53-7051" }, "soc_probability": { "type": "string", "description": "NIOCCS accuracy score (5.0=OSHA assigned, not probability)", "example": "0.947490000" }, "soc_reviewed": { "type": "integer", "description": "Review status: 0=Not reviewed, 1=Reviewed by OSHA, 2=Not SOC coded", "example": 0 }, "incident_location": { "type": ["string", "null"], "description": "PII-cleaned incident location", "example": "JPI Terminal Dock 2" }, "incident_description": { "type": ["string", "null"], "description": "PII-cleaned incident description" }, "before_incident_description": { "type": ["string", "null"], "description": "PII-cleaned narrative before incident", "example": "Working in vessel operations." }, "what_happened": { "type": ["string", "null"], "description": "PII-cleaned narrative of what happened", "example": "Puncture to right cheek from cheater bar" }, "injury_illness_description": { "type": ["string", "null"], "description": "PII-cleaned injury/illness description", "example": "CUT CRUSH MASH" }, "object_substance_description": { "type": ["string", "null"], "description": "PII-cleaned object/substance involved", "example": "Cheater bar." } } }, "SafetyMetrics": { "type": "object", "description": "5-year safety metrics and rates", "properties": { "trir5yr": { "type": "number", "description": "5-year Total Recordable Incident Rate", "example": 1.75 }, "dart5yr": { "type": "number", "description": "5-year Days Away, Restricted, or Transferred rate", "example": 1.75 }, "total_cases5yr": { "type": "integer", "description": "Total cases over 5 years", "example": 2 }, "total_hours5yr": { "type": "integer", "description": "Total hours worked over 5 years", "example": 227934 }, "years_of_data": { "type": "integer", "description": "Number of years of data available", "example": 1 } } }, "FmcdCompanyInfo": { "type": "object", "description": "DOT-level motor carrier company information from dot_company_census table", "properties": { "dot_number": { "type": "string", "description": "USDOT number", "example": "1001665" }, "mcs150_date": { "type": ["string", "null"], "format": "date", "description": "MCS-150 filing date - when the carrier last updated their biennial filing (required every 2 years)", "example": "2025-01-10" }, "legal_name": { "type": "string", "description": "Legal company name from DOT census", "example": "MIRACLE TRANSPORTATION INC" }, "dba_name": { "type": ["string", "null"], "description": "Doing Business As name from DOT census", "example": "TRANSPORTES MIRACLES SA DE CV" }, "phone": { "type": [ "string", "null" ], "description": "Phone number", "example": "4123044419" }, "fax": { "type": [ "string", "null" ], "description": "Fax number" }, "cell_phone": { "type": [ "string", "null" ], "description": "Cell phone number" }, "email": { "type": [ "string", "null" ], "description": "Email address", "example": "WILLA.CASH@GMAIL.COM" }, "business_address": { "$ref": "#/components/schemas/FmcdAddress" }, "mailing_address": { "$ref": "#/components/schemas/FmcdAddress" }, "business_organization": { "type": [ "string", "null" ], "description": "Business organization type" }, "registration_date": { "type": "string", "format": "date", "description": "Registration date", "example": "2023-04-01" }, "status": { "type": "string", "description": "Current status", "example": "A" }, "prior_revoked_flag": { "type": [ "string", "null" ], "description": "Prior revoked flag" }, "prior_revoke_dot_number": { "type": [ "string", "null" ], "description": "Prior revoked DOT number" }, "icc_number": { "type": ["string", "null"], "description": "DEPRECATED: Primary ICC/MC number (use docket fields instead). Concatenation of docket1prefix + docket1", "example": "MC1111926" }, "entity_type": { "type": "string", "description": "Entity type code (C=Carrier, S=Shipper)", "example": "C" }, "carrier_operation": { "type": "string", "description": "Carrier operation type (A=Authorized, I=Interstate, etc.)", "example": "A" }, "classification_category": { "type": "string", "description": "Classification definition category", "example": "AUTHORIZED FOR HIRE" }, "match_confidence": { "type": "number", "description": "Confidence score for linq_id business matching (0-100)", "example": 98.2 }, "match_type": { "type": "string", "description": "Method used for ID matching (exact, blocking_small, etc.)", "example": "blocking_small" }, "hm_ind": { "type": ["string", "null"], "description": "Hazardous Materials Indicator (Y/N)", "example": "N" }, "docket1prefix": { "type": ["string", "null"], "description": "First docket prefix (MC=Motor Carrier, FF=Freight Forwarder, BR=Broker)", "example": "MC" }, "docket1": { "type": ["integer", "null"], "description": "First docket number", "example": 438379 }, "docket2prefix": { "type": ["string", "null"], "description": "Second docket prefix (MC, FF, or BR)", "example": "MC" }, "docket2": { "type": ["integer", "null"], "description": "Second docket number", "example": 223533 }, "docket3prefix": { "type": ["string", "null"], "description": "Third docket prefix (MC, FF, or BR)" }, "docket3": { "type": ["integer", "null"], "description": "Third docket number" } } }, "FmcdAddress": { "type": "object", "properties": { "street": { "type": "string", "description": "Street address", "example": "2431 PARK HILL DR" }, "city": { "type": "string", "description": "City", "example": "PITTSBURGH" }, "state": { "type": "string", "description": "State abbreviation", "example": "PA" }, "zip": { "type": "string", "description": "ZIP code", "example": "15221" }, "country": { "type": "string", "description": "Country code", "example": "US" } } }, "FmcdFleetInfo": { "type": "object", "description": "Fleet composition and equipment details", "properties": { "total_drivers": { "type": "integer", "description": "Total number of drivers", "example": 4 }, "power_units": { "type": "integer", "description": "Number of power units", "example": 1 }, "truck_units": { "type": "integer", "description": "Number of truck units", "example": 1 }, "bus_units": { "type": "integer", "description": "Number of bus units", "example": 0 }, "total_cars": { "type": ["integer", "null"], "description": "Total number of cars" }, "fleetsize": { "type": ["string", "null"], "description": "Fleet size code category (A=0, B=1-5, C=6-10, D=11-20, E=21-50, F=51-100, G=101-200, H=201-500, I=501-1000, J=1001-2000, K=2001-3000, L=3001-4000, M=4001-5000+). See FLEET SIZE CODE table for power unit ranges.", "example": "B" }, "mcs150_mileage": { "type": [ "integer", "null" ], "description": "MCS-150 reported mileage" }, "mcs150_mileage_year": { "type": [ "integer", "null" ], "description": "MCS-150 mileage year" }, "total_cdl_drivers": { "type": "integer", "description": "Total CDL drivers", "example": 0 }, "drivers_breakdown": { "$ref": "#/components/schemas/DriversBreakdown" }, "mcs151_mileage": { "type": [ "integer", "null" ], "description": "MCS-151 mileage" }, "owned_equipment": { "$ref": "#/components/schemas/EquipmentBreakdown" }, "leased_equipment": { "$ref": "#/components/schemas/EquipmentBreakdown" }, "trip_leased_equipment": { "$ref": "#/components/schemas/TripLeasedEquipment" }, "cargo_classification": { "$ref": "#/components/schemas/CargoClassification" } } }, "DriversBreakdown": { "type": "object", "properties": { "interstate_beyond100": { "type": [ "integer", "null" ], "description": "Interstate drivers beyond 100 miles", "example": 1 }, "interstate_within100": { "type": [ "integer", "null" ], "description": "Interstate drivers within 100 miles", "example": 1 }, "intrastate_beyond100": { "type": [ "integer", "null" ], "description": "Intrastate drivers beyond 100 miles", "example": 1 }, "intrastate_within100": { "type": [ "integer", "null" ], "description": "Intrastate drivers within 100 miles", "example": 1 }, "avg_leased_per_month": { "type": [ "integer", "null" ], "description": "Average leased drivers per month" } } }, "EquipmentBreakdown": { "type": "object", "properties": { "trucks": { "type": [ "integer", "null" ], "description": "Number of trucks", "example": 1 }, "tractors": { "type": [ "integer", "null" ], "description": "Number of tractors" }, "trailers": { "type": [ "integer", "null" ], "description": "Number of trailers" }, "coaches": { "type": [ "integer", "null" ], "description": "Number of coaches" }, "school_buses": { "type": [ "integer", "null" ], "description": "Number of school buses", "example": 0 }, "buses": { "type": [ "integer", "null" ], "description": "Number of buses" }, "vans": { "type": [ "integer", "null" ], "description": "Number of vans", "example": 0 }, "limos": { "type": [ "integer", "null" ], "description": "Number of limousines", "example": 0 } } }, "TripLeasedEquipment": { "type": "object", "properties": { "trucks": { "type": [ "integer", "null" ], "description": "Trip-leased trucks" }, "tractors": { "type": [ "integer", "null" ], "description": "Trip-leased tractors" }, "school_buses": { "type": [ "integer", "null" ], "description": "Trip-leased school buses", "example": 0 }, "vans": { "type": [ "integer", "null" ], "description": "Trip-leased vans", "example": 0 }, "limos": { "type": [ "integer", "null" ], "description": "Trip-leased limousines", "example": 0 } } }, "CargoClassification": { "type": "object", "description": "Types of cargo hauled (marked with X if applicable)", "properties": { "general_freight": { "type": [ "string", "null" ], "description": "General freight", "example": "X" }, "household_goods": { "type": [ "string", "null" ], "description": "Household goods" }, "metal_sheet_coils_rolls": { "type": [ "string", "null" ], "description": "Metal sheets, coils, rolls" }, "motor_vehicles": { "type": [ "string", "null" ], "description": "Motor vehicles" }, "driveaway_towaway": { "type": [ "string", "null" ], "description": "Drive-away, tow-away" }, "logs_poles_lumber_beams": { "type": [ "string", "null" ], "description": "Logs, poles, lumber, beams" }, "building_materials": { "type": [ "string", "null" ], "description": "Building materials" }, "mobile_homes": { "type": [ "string", "null" ], "description": "Mobile homes" }, "machinery_large_objects": { "type": [ "string", "null" ], "description": "Machinery, large objects" }, "fresh_produce": { "type": [ "string", "null" ], "description": "Fresh produce" }, "liquids_gases": { "type": [ "string", "null" ], "description": "Liquids, gases" }, "intermodal_containers": { "type": [ "string", "null" ], "description": "Intermodal containers" }, "passengers": { "type": [ "string", "null" ], "description": "Passengers" }, "oilfield_equipment": { "type": [ "string", "null" ], "description": "Oilfield equipment" }, "livestock": { "type": [ "string", "null" ], "description": "Livestock" }, "grain_feed_hay": { "type": [ "string", "null" ], "description": "Grain, feed, hay" }, "coal_coke": { "type": [ "string", "null" ], "description": "Coal, coke" }, "meat": { "type": [ "string", "null" ], "description": "Meat" }, "garbage_refuse_trash": { "type": [ "string", "null" ], "description": "Garbage, refuse, trash" }, "us_mail": { "type": [ "string", "null" ], "description": "US mail" }, "chemicals": { "type": [ "string", "null" ], "description": "Chemicals" }, "commodities_dry_bulk": { "type": [ "string", "null" ], "description": "Commodities dry bulk" }, "refrigerated_foods": { "type": [ "string", "null" ], "description": "Refrigerated foods" }, "beverages": { "type": [ "string", "null" ], "description": "Beverages" }, "paper_products": { "type": [ "string", "null" ], "description": "Paper products" }, "utility": { "type": [ "string", "null" ], "description": "Utility" }, "farm_supplies": { "type": [ "string", "null" ], "description": "Farm supplies" }, "construction": { "type": [ "string", "null" ], "description": "Construction" }, "water_well": { "type": [ "string", "null" ], "description": "Water well" }, "other": { "type": [ "string", "null" ], "description": "Other" }, "other_description": { "type": [ "string", "null" ], "description": "Other description" } } }, "FmcdSafetyInfo": { "type": "object", "description": "DOT-level safety rating information (umbrella over all docket numbers)", "properties": { "safety_rating": { "type": ["string", "null"], "description": "DOT safety rating (S=Satisfactory, C=Conditional, U=Unsatisfactory)", "example": "S" }, "safety_rating_date": { "type": ["string", "null"], "format": "date", "description": "Safety rating date", "example": "2023-03-23" }, "last_review_date": { "type": ["string", "null"], "format": "date", "description": "Last safety review date", "example": "2023-03-07" }, "review_type": { "type": ["string", "null"], "description": "Type of review conducted (C=Compliance Review, S=Safety Audit)", "example": "S" } } }, "FmcdAuthorityRecord": { "type": "object", "description": "Authority record for a specific docket number from dot_motor_carrier_with_history table. CRITICAL: Each docket number has separate authority status.", "properties": { "docket_number": { "type": "string", "description": "Full docket number (prefix + number) - CRITICAL for linking insurance", "example": "MC438379" }, "prefix": { "type": "string", "description": "Docket prefix (MC=Motor Carrier, FF=Freight Forwarder, BR=Broker)", "example": "MC" }, "number": { "type": "integer", "description": "Docket number without prefix", "example": 438379 }, "mc_legal_name": { "type": ["string", "null"], "description": "Legal name from motor carrier record (may differ from census legal_name)", "example": "MIRACLE TRANSPORTATION INC" }, "mc_dba_name": { "type": ["string", "null"], "description": "DBA name from motor carrier record (may differ from census dba_name)", "example": "TRANSPORTES MIRACLES SA DE CV" }, "common_authority": { "type": "string", "description": "Common carrier authority status (A=Active, I=Inactive, N=Not authorized, P=Pending)", "example": "A" }, "contract_authority": { "type": "string", "description": "Contract carrier authority status (A=Active, I=Inactive, N=Not authorized, P=Pending)", "example": "N" }, "broker_authority": { "type": "string", "description": "Broker authority status (A=Active, I=Inactive, N=Not authorized, P=Pending)", "example": "N" }, "applications_pending": { "$ref": "#/components/schemas/ApplicationsPending" }, "revocation_pending": { "$ref": "#/components/schemas/RevocationPending" } } }, "RevocationPending": { "type": "object", "description": "Authorities currently in revocation process", "properties": { "common_rev_pend": { "type": "string", "description": "Common authority in revocation (Y=In revocation, N=Not in revocation)", "example": "N" }, "contract_rev_pend": { "type": "string", "description": "Contract authority in revocation (Y=In revocation, N=Not in revocation)", "example": "N" }, "broker_rev_pend": { "type": "string", "description": "Broker authority in revocation (Y=In revocation, N=Not in revocation)", "example": "N" } } }, "ApplicationsPending": { "type": "object", "properties": { "common": { "type": "string", "description": "Common authority pending", "example": "N" }, "contract": { "type": "string", "description": "Contract authority pending", "example": "N" }, "broker": { "type": "string", "description": "Broker authority pending", "example": "N" } } }, "InsuranceRequirements": { "type": "object", "description": "Insurance requirements for a specific docket number from dot_motor_carrier_with_history", "properties": { "docket_number": { "type": "string", "description": "Docket number this requirement is associated with (CRITICAL for linking)", "example": "MC438379" }, "min_coverage_amount": { "type": "string", "description": "Amount of BI&PD insurance required (in thousands)", "example": "00750" }, "cargo_required": { "type": "string", "description": "Cargo insurance required (Y/N)", "example": "N" }, "bond_required": { "type": "string", "description": "Bond required (Y/N)", "example": "N" }, "bipd_on_file": { "type": "string", "description": "Amount of BI&PD insurance on file (in thousands)", "example": "01000" }, "cargo_on_file": { "type": "string", "description": "Cargo insurance on file (Y/N)", "example": "N" }, "bond_on_file": { "type": "string", "description": "Bond on file (Y/N)", "example": "N" } } }, "CurrentInsuranceRecord": { "type": "object", "description": "Current active insurance from dot_insurance_all_with_history. Records for active or pending individual insurance policies linked by docket_number.", "properties": { "docket_number": { "type": "string", "description": "Docket number this insurance is associated with (CRITICAL for linking to authority)", "example": "MC438379" }, "ins_type_code": { "type": "string", "description": "Insurance type code: 1=BI&PD, 2=Cargo, 3=Bond, 4=Trust Fund", "example": "1" }, "ins_class_code": { "type": "string", "description": "Insurance class: P=Primary, E=Excess, 1=Full Security Limits Under Section 1043.2(b)(1), 2=Full Security Limits Under Section 1043.2(b)(2)", "example": "P" }, "max_cov_amount": { "type": "string", "description": "Maximum Dollar Limit (company shall not be liable for amounts in excess of) in thousands", "example": "01000" }, "underl_lim_amount": { "type": ["string", "null"], "description": "BI&PD Underlying Dollar Limit (when ins_class_code is E, this is the value of primary insurance)", "example": null }, "ins_form_code": { "type": "string", "description": "Insurance form code: 34=Cargo, 82=BI&PD, 83=Cargo, 84=Property Broker's Surety Bond, 85=Property Broker's Trust Fund Agreement, 91/91X=BI&PD variants", "example": "91X" }, "policy_no": { "type": "string", "description": "Policy number", "example": "NHS1721189" }, "effective_date": { "type": "string", "description": "Policy effective date", "example": "07/19/2025" }, "name_company": { "type": "string", "description": "Insurance company name", "example": "NEW HORIZON INSURANCE COMPANY" } } }, "PreviousInsuranceRecord": { "type": "object", "description": "Previous/historical insurance from dot_insurance_hist_all. Contains cancelled, replaced, name changed, or transferred policies. IMPORTANT: This is NOT the subsequent policy.", "properties": { "docket_number": { "type": "string", "description": "Docket number this insurance is associated with (CRITICAL for linking to authority)", "example": "MC438379" }, "insurance_hist_id": { "type": "integer", "description": "Unique identifier for the historical insurance record", "example": 22562524 }, "ins_form_code": { "type": "string", "description": "Insurance form code: 34=Cargo, 82=BI&PD, 83=Cargo, 84=Property Broker's Surety Bond, 85=Property Broker's Trust Fund Agreement, 91/91X=BI&PD variants", "example": "91X" }, "mod_col_1": { "type": "string", "description": "Cancellation method: cancelled, replaced, name change, or transferred", "example": "replaced" }, "ins_cancl_form": { "type": "string", "description": "Cancellation form codes: 35=BMC Cancellation Form, 36=BMC Surety Bond Cancellation Form, 85C=BMC Cancellation for Trust Funds. For 'Replaced' will be one of the ins_form_codes. For 'Name Change' is 'NC'. For 'Transferred' is 'TR'.", "example": "91X" }, "mod_col_2": { "type": "string", "description": "Insurance Type Indicator: ' '(space)=BIPD, '*'=Not BIPD (Cargo, Surety, or Trust Fund)", "example": " " }, "policy_no": { "type": "string", "description": "Policy number", "example": "NHS1432238" }, "min_cov_amount": { "type": "string", "description": "The minimum insurance amount required for the entity (carrier, broker, etc.), in thousands", "example": "00750" }, "ins_class_code": { "type": "string", "description": "For BI&PD form codes; indicates whether the insurance policy is primary ('P') or excess ('E')", "example": "P" }, "mod_col_4": { "type": ["string", "null"], "description": "BI&PD Underlying limit amount (in thousands). When ins_class_code is 'E', this is the value of the primary insurance.", "example": null }, "mod_col_5": { "type": "string", "description": "BI&PD Max Coverage Amount - The maximum dollar amount covered by the insurance policy (in thousands)", "example": "01000" }, "effective_date": { "type": "string", "description": "Original effective date of the policy", "example": "07/19/2024" }, "cancl_effective_date": { "type": "string", "description": "Cancellation effective date", "example": "07/19/2024" }, "cancl_method": { "type": "string", "description": "Cancellation method: TERM/CANCL=cancellation was executed by FMCSA, Term/REPL=replacement was executed by a new policy submission", "example": "Term/REPL" }, "name_company": { "type": "string", "description": "Insurance company name", "example": "NEW HORIZON INSURANCE COMPANY" } } }, "BizcoreObject": { "type": "object", "description": "Business core intelligence including overview, metrics, and classification", "properties": { "business_overview": { "$ref": "#/components/schemas/BusinessOverview" }, "firmographic_metrics": { "$ref": "#/components/schemas/FirmographicMetrics" }, "classification": { "$ref": "#/components/schemas/BizcoreClassification" }, "industry_keywords": { "type": "array", "items": { "type": "string" }, "description": "Industry keywords", "example": [ "Trucking", "Intercity Trucking", "Freight Forwarder" ] }, "products_services": { "type": "array", "items": { "$ref": "#/components/schemas/BizcoreProductService" } }, "data_source": { "type": "string", "description": "Data source identifier", "example": "linq_business" } } }, "BusinessOverview": { "type": "object", "properties": { "business_id": { "type": "string", "description": "Unique business identifier", "example": "1525b8ec5ef863b9264b4a99e734b2dccc6bea1a" }, "description": { "type": "string", "description": "AI-generated business description" }, "confidence_score": { "type": "number", "description": "Confidence score for business intelligence", "example": 0.9951 }, "last_updated": { "type": "string", "format": "date-time", "description": "Last update timestamp", "example": "2025-11-25T15:22:10.763114" } } }, "FirmographicMetrics": { "type": "object", "description": "Key business metrics with confidence scores", "properties": { "revenue": { "type": "string", "description": "Annual revenue (formatted currency string)", "example": "$229,773.58" }, "revenue_raw": { "type": "number", "description": "Annual revenue (raw numeric value)", "example": 229773.57569686108 }, "revenue_confidence_score": { "type": "number", "description": "Confidence score for revenue estimate (0-100)", "example": 65.45 }, "employee_count": { "type": "integer", "description": "Number of employees", "example": 5 }, "employee_confidence_score": { "type": "number", "description": "Confidence score for employee count (0-100)", "example": 39.79 } } }, "BizcoreClassification": { "type": "object", "description": "Business classification with NAICS, compensation, and ISO codes", "properties": { "naics_codes": { "type": "array", "items": { "$ref": "#/components/schemas/BizcoreNaicsCode" }, "description": "Ranked NAICS codes" }, "primary_naics": { "$ref": "#/components/schemas/BizcoreNaicsCode" }, "compensation_codes": { "type": "array", "items": { "type": "integer" }, "description": "Workers compensation codes", "example": [ 7228, 7229, 7230, 7231, 7232 ] }, "iso_codes": { "type": "array", "items": { "$ref": "#/components/schemas/BizcoreIsoCode" }, "description": "ISO codes" } } }, "BizcoreNaicsCode": { "type": "object", "properties": { "code": { "type": "integer", "description": "NAICS code", "example": 484230 }, "rank": { "type": "integer", "description": "Ranking", "example": 1 }, "score": { "type": "number", "description": "Confidence score", "example": 0.89546 }, "title": { "type": "string", "description": "NAICS title", "example": "Specialized Freight (except Used Goods) Trucking, Long-Distance" } } }, "BizcoreIsoCode": { "type": "object", "properties": { "iso_code": { "type": "integer", "description": "ISO code number", "example": 99793 }, "description": { "type": "string", "description": "ISO code description", "example": "Truckers" } } }, "BizcoreProductService": { "type": "object", "properties": { "name": { "type": "string", "description": "Product or service name", "example": "Cross-Docking Services" }, "description": { "type": "string", "description": "Detailed description", "example": "Rapid transfer of goods between trailers to minimize handling and storage time." } } }, "WorkcompObject": { "type": "object", "description": "Workers Compensation policy and experience data", "properties": { "policy_info": { "$ref": "#/components/schemas/WorkcompPolicyInfo" }, "employer_info": { "$ref": "#/components/schemas/WorkcompEmployerInfo" }, "experience_data": { "$ref": "#/components/schemas/WorkcompExperienceData" }, "coverage_details": { "$ref": "#/components/schemas/WorkcompCoverageDetails" } } }, "WorkcompPolicyInfo": { "type": "object", "properties": { "policy_number": { "type": [ "string", "null" ], "description": "Workers compensation policy number" }, "carrier_name": { "type": "string", "description": "Insurance carrier name", "example": "SAIF CORPORATION" }, "carrier_ncci_id": { "type": [ "string", "null" ], "description": "NCCI carrier ID" }, "carrier_address": { "type": "object", "properties": { "street": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "state": { "type": [ "string", "null" ] }, "zip": { "type": [ "string", "null" ] } } }, "policy_effective_date": { "type": "string", "format": "date", "description": "Policy effective date", "example": "2025-07-01" }, "policy_expiration_date": { "type": "string", "format": "date", "description": "Policy expiration date", "example": "2026-07-01" }, "policy_cancellation_date": { "type": [ "string", "null" ], "format": "date", "description": "Policy cancellation date if applicable" }, "reinstatement_date": { "type": [ "string", "null" ], "format": "date", "description": "Policy reinstatement date if applicable" }, "end_reason": { "type": [ "string", "null" ], "description": "Reason for policy end" } } }, "WorkcompEmployerInfo": { "type": "object", "properties": { "employer_name": { "type": "string", "description": "Employer legal name", "example": "LAKESIDE LUMBER INC" }, "dba": { "type": [ "string", "null" ], "description": "Doing business as name", "example": "LAKESIDE LUMBER CO" }, "fein": { "type": [ "string", "null" ], "description": "Federal Employer Identification Number" }, "address": { "type": "object", "properties": { "street": { "type": "string", "example": "10600 SW TLTN/SHRWD RD" }, "city": { "type": "string", "example": "TUALATIN" }, "state": { "type": "string", "example": "OR" }, "zip": { "type": "string", "example": "97062" } } }, "county": { "type": [ "string", "null" ], "description": "County name", "example": "Washington" }, "naics": { "type": "string", "description": "NAICS code", "example": "444180" }, "employee_range": { "type": [ "string", "null" ], "description": "Employee count range", "example": "50-99" }, "number_of_locations": { "type": [ "integer", "null" ], "description": "Number of business locations" }, "reporting_state": { "type": "string", "description": "State where policy is reported", "example": "OR" } } }, "WorkcompExperienceData": { "type": "object", "properties": { "experience_mod": { "type": [ "number", "null" ], "description": "Experience modification factor" }, "lost_cost": { "type": [ "number", "null" ], "description": "Lost cost multiplier" }, "lcm": { "type": [ "number", "null" ], "description": "Loss cost multiplier" }, "vol_assigned_risk": { "type": [ "string", "null" ], "description": "Voluntary or assigned risk indicator" }, "governing_class": { "type": "string", "description": "Governing class code", "example": "8232" } } }, "WorkcompCoverageDetails": { "type": "object", "properties": { "match_type": { "type": [ "string", "null" ], "description": "Type of match performed" }, "match_confidence": { "type": "string", "description": "Confidence score for match", "example": "blocking" }, "last_updated": { "type": "string", "description": "Last update timestamp", "example": "0.95" }, "source_table": { "type": "string", "description": "Source data table", "example": "2025-09-17T12:55:20.808532" }, "source_database": { "type": "string", "description": "Source database name", "example": "linq_workers_comp_oregon" } } }, "HailRingParams": { "type": "object", "description": "Hail events >= 1 inch by distance rings", "properties": { "ring_0_1_mile": {"type": "integer", "example": 0}, "cummulative_0_1_mile": {"type": "integer", "example": 0}, "ring_1_2_mile": {"type": "integer", "example": 0}, "cummulative_0_2_mile": {"type": "integer", "example": 0}, "ring_2_3_mile": {"type": "integer", "example": 2}, "cummulative_0_3_mile": {"type": "integer", "example": 2}, "ring_3_4_mile": {"type": "integer", "example": 0}, "cummulative_0_4_mile": {"type": "integer", "example": 2}, "ring_4_5_mile": {"type": "integer", "example": 4}, "cummulative_0_5_mile": {"type": "integer", "example": 6} } }, "TornadoRingParams": { "type": "object", "description": "Recorded tornado events by distance rings", "properties": { "ring_0_1_mile": {"type": "integer", "example": 0}, "cummulative_0_1_mile": {"type": "integer", "example": 0}, "ring_1_2_mile": {"type": "integer", "example": 0}, "cummulative_0_2_mile": {"type": "integer", "example": 0}, "ring_2_3_mile": {"type": "integer", "example": 0}, "cummulative_0_3_mile": {"type": "integer", "example": 0}, "ring_3_4_mile": {"type": "integer", "example": 2}, "cummulative_0_4_mile": {"type": "integer", "example": 2}, "ring_4_5_mile": {"type": "integer", "example": 2}, "cummulative_0_5_mile": {"type": "integer", "example": 4} } }, "WindRingParams": { "type": "object", "description": "Known damaging wind events by distance rings", "properties": { "ring_0_1_mile": {"type": "integer", "example": 0}, "cummulative_0_1_mile": {"type": "integer", "example": 0}, "ring_1_2_mile": {"type": "integer", "example": 1}, "cummulative_0_2_mile": {"type": "integer", "example": 1}, "ring_2_3_mile": {"type": "integer", "example": 4}, "cummulative_0_3_mile": {"type": "integer", "example": 5}, "ring_3_4_mile": {"type": "integer", "example": 7}, "cummulative_0_4_mile": {"type": "integer", "example": 12}, "ring_4_5_mile": {"type": "integer", "example": 5}, "cummulative_0_5_mile": {"type": "integer", "example": 17} } }, "Hardiness": { "type": "object", "description": "USDA Plant Hardiness Zone information", "properties": { "avextmin": { "type": "string", "description": "Average extreme minimum temperature", "example": "20 to 30 F" }, "zone": { "type": "string", "description": "Hardiness zone number", "example": "9" }, "avextmin5": { "type": "string", "description": "Average extreme minimum temperature in 5-degree increments", "example": "25 to 30 F" }, "zoneseg": { "type": "string", "description": "Hardiness zone segment", "example": "9b" } } }, "FemaAllFloodParams": { "type": "object", "description": "Detailed FEMA Digital Flood Insurance Rate Map (DFIRM) parameters", "properties": { "dfirm_id": {"type": ["string", "null"], "example": "48201C"}, "version_id": {"type": ["string", "null"], "example": "1.1.1.0"}, "fld_ar_id": {"type": ["string", "null"], "example": "48201C_5768"}, "study_typ": {"type": ["string", "null"], "example": "NP"}, "fld_zone": {"type": ["string", "null"], "description": "FEMA flood zone", "example": "X"}, "zone_subty": {"type": ["string", "null"], "description": "Zone subtype", "example": "0.2 PCT ANNUAL CHANCE FLOOD HAZARD"}, "sfha_tf": {"type": ["string", "null"], "description": "Special Flood Hazard Area: T/F/U", "example": "F"}, "static_bfe": {"type": ["number", "null"], "description": "Static Base Flood Elevation (-9999 = not available)", "example": -9999}, "v_datum": {"type": ["string", "null"], "description": "Vertical datum", "example": "NAVD88"}, "depth": {"type": ["number", "null"], "description": "Depth for Zone AO areas", "example": -9999}, "len_unit": {"type": ["string", "null"], "description": "Length units", "example": "Feet"}, "velocity": {"type": ["number", "null"], "description": "Mean velocity of floodway", "example": -9999}, "vel_unit": {"type": ["string", "null"], "description": "Velocity units"}, "ar_revert": {"type": ["string", "null"], "description": "Zone AR reversion zone"}, "ar_subtrv": {"type": ["string", "null"], "description": "Zone AR reversion subtype"}, "bfe_revert": {"type": ["number", "null"], "description": "BFE revert value", "example": -9999}, "dep_revert": {"type": ["number", "null"], "description": "Depth revert value", "example": -9999}, "dual_zone": {"type": ["string", "null"], "description": "Dual zone classification"}, "source_cit": {"type": ["string", "null"], "description": "Source citation", "example": "48201C_STUDY1"} } }, "DistanceToSignificantFloodParams": { "type": "object", "description": "Distance to 100-year floodplain if within 1/2 mile", "properties": { "elevation_in_feet": { "type": "object", "properties": { "value": {"type": ["number", "null"], "example": 19.82} } }, "distance_to_100yr_floodplain": {"type": ["string", "null"], "example": "406 ft"}, "elevation100": {"type": ["string", "null"], "example": "16.08 ft"}, "elevation_difference": {"type": ["string", "null"], "example": "3.74 ft"} } }, "BaseFloodElevation": { "type": "object", "description": "FEMA Base Flood Elevation details", "properties": { "text": {"type": "string", "example": "0.277 MILES from BFE = 16 feet"}, "meter": {"type": ["number", "null"], "example": 445}, "distance": { "type": "object", "properties": { "value": {"type": ["number", "null"], "example": 0.27681}, "units": {"type": ["string", "null"], "example": "miles"} } }, "elevation": { "type": "object", "properties": { "value": {"type": ["number", "null"], "example": 16.2}, "units": {"type": ["string", "null"], "example": "feet"} } } } }, "FemaMapParams": { "type": "object", "properties": { "fema_flood_map_url": { "type": "string", "description": "Link to FEMA flood map", "example": "https://msc.fema.gov/portal/search?AddressQuery=-95.11392%2C%2029.75109#searchresultsanchor" } } }, "EnhancedHazardhubFloodParams": { "type": "object", "description": "Components to Enhanced HazardHub Flood Score", "properties": { "dist": {"type": ["number", "null"], "description": "Distance to nearest flooding feature (feet)", "example": 1418}, "elevnff": {"type": ["number", "null"], "description": "Elevation of nearest flood feature", "example": -1}, "elev_pt": {"type": ["number", "null"], "description": "Elevation of location", "example": 20}, "diff": {"type": ["number", "null"], "description": "Elevation difference", "example": 20}, "lines_distance": {"type": ["number", "null"], "description": "Distance to nearest line flood feature"}, "lines_diff": {"type": ["number", "null"], "description": "Elevation diff to line feature"}, "lines_score": {"type": ["string", "null"], "description": "Flood score from line feature", "example": "A"}, "lines_name": {"type": ["string", "null"], "description": "Name of line flood feature"}, "lines_descrip": {"type": ["string", "null"], "description": "Description of line feature", "example": "Intermittent Stream Or Wash"}, "polygons_distance": {"type": ["number", "null"], "description": "Distance to nearest polygon flood feature", "example": 1418}, "polygons_diff": {"type": ["number", "null"], "description": "Elevation diff to polygon feature", "example": 20}, "polygons_score": {"type": ["string", "null"], "description": "Flood score from polygon feature", "example": "F"}, "polygon_type": {"type": ["string", "null"], "description": "Type of polygon flood feature", "example": "Large River"}, "polygon_name": {"type": ["string", "null"], "description": "Name of polygon flood feature"}, "polygon_descrip": {"type": ["string", "null"], "description": "Description of polygon", "example": "River"} } }, "HazardhubCatastrophicFloodParams": { "type": "object", "description": "Components to Catastrophic HazardHub Flood Score", "properties": { "cat_dist": {"type": ["number", "null"], "example": 1418}, "cat_elevnff": {"type": ["number", "null"], "example": -1}, "cat_elev_pt": {"type": ["number", "null"], "example": 20}, "cat_diff": {"type": ["number", "null"], "example": 20}, "cat_lines_distance": {"type": ["number", "null"]}, "cat_lines_diff": {"type": ["number", "null"]}, "cat_lines_score": {"type": ["string", "null"], "example": "A"}, "cat_lines_name": {"type": ["string", "null"]}, "cat_lines_descrip": {"type": ["string", "null"], "example": "Intermittent Stream Or Wash"}, "cat_polygons_distance": {"type": ["number", "null"], "example": 1418}, "cat_polygons_diff": {"type": ["number", "null"], "example": 20}, "cat_polygons_score": {"type": ["string", "null"], "example": "F"}, "cat_polygon_type": {"type": ["string", "null"], "example": "Large River"}, "cat_polygon_name": {"type": ["string", "null"]}, "cat_polygon_descrip": {"type": ["string", "null"], "example": "River"} } }, "ConvectionStorm": { "type": "object", "description": "Thunderstorm events per decade (legacy/deprecated)", "properties": { "score": {"type": ["string", "null"], "description": "Grade A-F"}, "text": {"type": ["string", "null"], "description": "Text description"} } }, "ConvectionStormPerDecade": { "type": "object", "properties": { "value": {"type": ["string", "null"], "description": "Number of convection storms per decade", "example": "197"} } }, "HhElevation": { "type": "object", "description": "HazardHub elevation data for property", "properties": { "slope": {"type": "string", "description": "Slope in degrees 0-90", "example": "0.66 degrees"}, "aspect": {"type": "string", "description": "Direction property faces/slopes toward", "example": "33.2 degrees"}, "elevation": {"type": "string", "description": "Elevation in feet", "example": "19.82 feet"} } }, "AspectRisk": { "type": "object", "description": "Property aspect/orientation risk", "properties": { "aspect": {"type": "string", "example": "33.2 degrees"}, "score": {"type": "string", "description": "Grade A-F", "example": "A"}, "direction": {"type": "string", "description": "Compass direction", "example": "North"} } }, "SlopeRisk": { "type": "object", "description": "Property slope risk assessment", "properties": { "slope": {"type": "string", "example": "0.66 degrees"}, "score": {"type": "string", "description": "Grade A-F", "example": "A"}, "description": {"type": "string", "example": "Flat to Very Low"} } }, "CrimeDetail": { "type": "object", "description": "Detailed crime risk by category", "properties": { "score": {"type": ["string", "null"], "description": "Grade A-F", "example": "C"}, "text": {"type": ["string", "null"], "description": "Risk description", "example": "Average murder rate"}, "value": {"type": ["integer", "null"], "description": "Scale 0-200", "example": 128} } }, "EnhancedWindParams": { "type": "object", "description": "Enhanced wind risk analysis within 25-mile radius", "properties": { "score": {"type": "string", "description": "Letter grade A-F", "example": "C"}, "text": {"type": "string", "description": "Text-based risk level", "example": "Moderate"}, "scale": {"type": "integer", "description": "Numeric scale 0-35+", "example": 37}, "historical_wind_events": { "type": "object", "properties": { "wind_rad": { "type": "string", "description": "Likelihood of damaging wind in 10-year period", "example": "95% chance of damaging wind occurrence in 10 years in a 1.89 mile radius" } } }, "num_of_damaging_wind_incidents_within_25_miles_since_1996": {"type": "integer", "example": 346}, "num_of_damaging_wind_incidents_within_25_miles_last_23_years": {"type": "integer", "example": 346}, "count_within_25_miles_for_last_decade": {"type": "integer", "example": 175}, "nearest_wind_incident": { "$ref": "#/components/schemas/WeatherIncident" }, "waddrisk": {"type": "number", "description": "Annual probability of wind at address", "example": 0.076722}, "wpctrisk": {"type": "string", "description": "Percentage probability of wind at address", "example": "7.6722%"} } }, "UnderwritingQuestionCategory": { "type": "object", "description": "Industry-specific underwriting questions grouped by category", "properties": { "category": { "type": "string", "description": "Question category (industry-specific)", "example": "Home Furnishings" }, "questions": { "type": "array", "items": { "$ref": "#/components/schemas/UnderwritingQuestion" }, "description": "Array of questions for this category" } } }, "UnderwritingQuestion": { "type": "object", "description": "Individual underwriting question", "properties": { "question_id": { "type": "string", "description": "Unique question identifier", "example": "UQ000659" }, "question_text": { "type": "string", "description": "The underwriting question text", "example": "Does the applicant do framing on premises?" } } } } }, "tags": [ { "name": "Authentication", "description": "OAuth2 authentication endpoints" }, { "name": "Business Search", "description": "Search for businesses to get entity IDs" }, { "name": "Business Intelligence", "description": "Comprehensive business intelligence via LinqConnect" } ] }