{
  "info": {
    "name": "LinqConnect API Collection v1.4.0",
    "description": "# LinqConnect API - AI Data Aggregation and Verification for Insurance\n\n## Overview\nLinqConnect delivers 20-25% more accurate business intelligence through 7 Specialized AI Agents orchestrated by a custom LLM. This collection provides examples for all available features.\n\n## Quick Start\n1. **Set Environment Variables**: Configure DEMO_API_KEY (advisor@2024) and ENTERPRISE_ID\n2. **Run Business Search**: Find a business to get an entity_id\n3. **Get Intelligence**: Call LinqConnect with desired features\n\n## Available Features\n- **BIZCORE**: Business core intelligence (overview, metrics, classification)\n- **FIRMO**: Comprehensive firmographics and business information\n- **CVG**: Insurance coverage recommendations\n- **EXP**: Business exposure analysis\n- **RISK**: Risk assessment and mitigation strategies\n- **UWQ**: Industry-specific underwriting questions\n- **PROPERTY**: Property attributes and valuation\n- **RISK_PROPERTY**: Property risk analysis (hazards, natural disasters)\n- **REPLACEMENT**: Building replacement cost analysis\n- **FLOOD**: Detailed flood risk assessment\n- **FMCD**: DOT Fleet and Motor Carrier data\n- **OSHA**: OSHA safety compliance and incident data\n- **WORKCOMP**: Workers compensation policy and experience data\n\n## Important: API Response Naming\n**All API responses use snake_case field naming** (e.g., `business_information`, `dba_name`, `start_year`, `total_dafw_cases`)\n\n## Environments\n- **Production Auth**: https://api.linqura.ai (OAuth2 tokens)\n- **Demo API**: https://demo-api.linqura.ai (All LinqConnect calls)\n- **Demo API Key**: advisor@2024\n\n## Need Help?\nContact: support@linqura.com | https://linqura.com/contact",
    "version": "1.4.0",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "x-api-key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{DEMO_API_KEY}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "authUrl",
      "value": "https://api.linqura.ai",
      "type": "string",
      "description": "Production auth endpoint - always use this for OAuth2 tokens"
    },
    {
      "key": "demoUrl", 
      "value": "https://demo-api.linqura.ai",
      "type": "string",
      "description": "Demo environment for all LinqConnect API calls"
    },
    {
      "key": "CLIENT_ID",
      "value": "your-client-id",
      "type": "string",
      "description": "Your OAuth2 client ID (contact Linqura for credentials)"
    },
    {
      "key": "CLIENT_SECRET",
      "value": "your-client-secret",
      "type": "string",
      "description": "Your OAuth2 client secret"
    },
    {
      "key": "SCOPE",
      "value": "default-m2m-resource-server-polax1/linqdata",
      "type": "string",
      "description": "Required OAuth2 scope for LinqConnect"
    },
    {
      "key": "ACCESS_TOKEN",
      "value": "",
      "type": "string",
      "description": "OAuth2 access token (auto-populated after authentication)"
    },
    {
      "key": "DEMO_API_KEY",
      "value": "advisor@2024",
      "type": "string",
      "description": "Demo environment API key"
    },
    {
      "key": "ENTERPRISE_ID",
      "value": "demo_enterprise",
      "type": "string",
      "description": "Your enterprise identifier"
    }
  ],
  "item": [
    {
      "name": "Authentication",
      "description": "OAuth2 authentication to get access tokens. Auth always uses api.linqura.ai",
      "item": [
        {
          "name": "Get OAuth2 Access Token",
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "// Save access token to environment",
                  "if (pm.response.code === 200) {",
                  "    const jsonData = pm.response.json();",
                  "    pm.environment.set('ACCESS_TOKEN', jsonData.access_token);",
                  "    console.log('Access token saved to environment');",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/x-www-form-urlencoded"
              }
            ],
            "body": {
              "mode": "urlencoded",
              "urlencoded": [
                {
                  "key": "grant_type",
                  "value": "client_credentials",
                  "type": "text"
                },
                {
                  "key": "client_id",
                  "value": "{{CLIENT_ID}}",
                  "type": "text"
                },
                {
                  "key": "client_secret",
                  "value": "{{CLIENT_SECRET}}",
                  "type": "text"
                },
                {
                  "key": "scope",
                  "value": "{{SCOPE}}",
                  "type": "text"
                }
              ]
            },
            "url": {
              "raw": "{{authUrl}}/auth/oauth2/token",
              "host": ["{{authUrl}}"],
              "path": ["auth", "oauth2", "token"]
            },
            "description": "**OAuth2 Client Credentials Flow**\n\nExchange your client credentials for an access token. This token is valid for 1 hour.\n\n**Required Variables:**\n- CLIENT_ID: Your OAuth2 client ID\n- CLIENT_SECRET: Your OAuth2 client secret\n- SCOPE: default-m2m-resource-server-polax1/linqdata\n\n**Note:** Authentication always uses production endpoint (api.linqura.ai)"
          }
        }
      ]
    },
    {
      "name": "Business Search",
      "description": "Search for businesses to obtain entity IDs for LinqConnect intelligence calls",
      "item": [
        {
          "name": "Search Business by Name",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{demoUrl}}/opensearch-sybl?q=Thermal Dynamics Corporation West Lebanon NH",
              "host": ["{{demoUrl}}"],
              "path": ["opensearch-sybl"],
              "query": [
                {
                  "key": "q",
                  "value": "Thermal Dynamics Corporation West Lebanon NH",
                  "description": "Business name, address, city, state"
                }
              ]
            },
            "description": "**Search for businesses to get entity IDs**\n\nSearch by business name, address, city, or state. Returns entity IDs (uid) that you can use with LinqConnect.\n\n**No authentication required for demo environment**\n\n**Example Searches:**\n- Business name only: \"Bailey's Garage\"\n- Name + location: \"Thermal Dynamics West Lebanon NH\"\n- Address: \"82 Benning St West Lebanon\"\n\n**Response includes:**\n- uid: Entity ID for LinqConnect\n- busName: Business name\n- busAddress: Full address"
          }
        }
      ]
    },
    {
      "name": "Core Business Intelligence",
      "description": "Essential business data and classification features",
      "item": [
        {
          "name": "BIZCORE - Business Core Intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"basic\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"entity_zip_code\": \"03784\",\n  \"features\": \"BIZCORE\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**BIZCORE Feature - Business Core Intelligence**\n\n**Returns (all snake_case):**\n- business_overview:\n  - business_id, description\n  - confidence_score, last_updated\n- firmographic_metrics (WITH CONFIDENCE SCORES):\n  - revenue (formatted string: \"$229,773.58\")\n  - revenue_raw (numeric: 229773.58)\n  - revenue_confidence_score (0-100 score)\n  - employee_count (integer)\n  - employee_confidence_score (0-100 score)\n- classification:\n  - naics_codes (ranked with scores)\n  - primary_naics\n  - compensation_codes, iso_codes\n- industry_keywords: Industry-specific keywords\n- products_services: Products and services offered\n- data_source: \"linq_business\"\n\n**Use Cases:**\n- Quick business overview with confidence metrics\n- Revenue and employee estimation with accuracy scores\n- Lead qualification\n- Initial business research\n\n**Example Business:** Trucking companies, small businesses"
          }
        },
        {
          "name": "FIRMO - Complete Firmographics",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"entity_zip_code\": \"03784\",\n  \"features\": \"FIRMO\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**FIRMO Feature - Comprehensive Firmographics**\n\n**Returns:**\n- businessInformation: Legal name, DBA, location, website, start year, description, match score\n- classification: Primary/secondary NAICS (verified), SIC codes, FEIN, ISO GL codes, WC compensation codes\n- metrics: Revenue, employee count with confidence codes\n- productServices: Detailed products and services\n- industryKeywords: Industry terms\n- additionalData: 50+ extended fields including:\n  - Financial: Strength, momentum, payroll\n  - Legal: Bankruptcy history, legal status\n  - Operational: Manufacturing indicator, import/export, hierarchy\n  - Corporate: Public/private, Fortune 1000, subsidiary status\n\n**Use Cases:**\n- Complete underwriting submission\n- Detailed business analysis\n- Risk classification\n- Carrier appetite matching"
          }
        }
      ]
    },
    {
      "name": "Insurance Analysis",
      "description": "Coverage recommendations, exposures, and risk assessment",
      "item": [
        {
          "name": "CVG - Coverage Recommendations",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"CVG\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**CVG Feature - Insurance Coverage Recommendations**\n\n**Returns:**\n- recommended: Priority coverage recommendations with:\n  - coverageId, coverageName\n  - rank (priority order)\n  - score (relevance score)\n  - definition (detailed rationale)\n- additional: Secondary coverage options\n\n**Use Cases:**\n- Coverage gap analysis\n- Policy recommendations\n- Cross-selling opportunities\n- Coverage adequacy assessment"
          }
        },
        {
          "name": "EXP - Exposure Analysis",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"EXP\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**EXP Feature - Business Exposure Analysis**\n\n**Returns:**\nArray of exposure items with:\n- exposureId: Unique identifier\n- exposureName: Type of exposure\n- definition: Detailed description and risk factors\n\n**Common Exposures:**\n- Equipment Breakdown\n- Cyber Liability\n- Professional Liability\n- Employment Practices\n- Environmental Impairment\n\n**Use Cases:**\n- Identify coverage needs\n- Risk assessment\n- Policy structuring"
          }
        },
        {
          "name": "RISK - Risk Assessment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"RISK\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**RISK Feature - Detailed Risk Assessment**\n\n**Returns:**\nArray of risk assessment items with:\n- riskId: Unique identifier\n- exposureId: Related exposure\n- listOfRisk: Array of specific risks containing:\n  - causeOfLoss: Specific risk scenario\n  - magnitude: low, medium, high, extreme, very extreme\n  - mitigatingFactors: Recommended mitigation strategies\n\n**Use Cases:**\n- Risk evaluation\n- Underwriting decision support\n- Premium calculation\n- Loss control recommendations"
          }
        },
        {
          "name": "UWQ - Underwriting Questions",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"UWQ\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**UWQ Feature - Industry-Specific Underwriting Questions**\n\n**Returns:**\nCustomized underwriting questions based on:\n- Industry classification\n- Business operations\n- Risk exposures\n- Coverage requirements\n\n**Use Cases:**\n- Application completion\n- Risk information gathering\n- Underwriting submission preparation\n- Due diligence"
          }
        },
        {
          "name": "UWQ - Underwriting Questions",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"UWQ\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**UWQ Feature - Industry-Specific Underwriting Questions**\n\n**Returns (snake_case):**\nArray of question categories, each containing:\n- category: Question category name (industry-specific)\n  - \"Home Furnishings\"\n  - \"Linoleum and Tile Stores\"\n  - \"General Merchandise Stores\"\n  - etc.\n- questions: Array of question objects:\n  - question_id: Unique identifier (e.g., \"UQ000659\")\n  - question_text: The actual question text\n\n**Example Questions:**\n- \"Does the applicant do framing on premises?\"\n- \"Are red label glues and/or adhesives kept on premises?\"\n- \"Does the applicant have a procedure to prevent shoplifting?\"\n- \"What percentage of the stock is used?\"\n- \"If yes, describe storage techniques?\"\n\n**Question Categories Based On:**\n- Primary NAICS code\n- Industry classification\n- Business operations\n- Risk exposures\n\n**Use Cases:**\n- Application completion\n- Risk information gathering\n- Underwriting submission preparation\n- Coverage determination\n- Loss control assessment\n\n**Note:** Questions are dynamically generated based on the business's industry classification and risk profile."
          }
        },
        {
          "name": "CVG + EXP + RISK - Complete Insurance Analysis",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"CVG,EXP,RISK,UWQ\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Combined Insurance Analysis Features**\n\n**Features Included:**\n- CVG: Coverage recommendations (recommended + additional)\n- EXP: Business exposures\n- RISK: Detailed risk assessment by exposure\n- UWQ: Underwriting questions\n\n**Perfect for:**\n- Complete underwriting analysis\n- New business quoting\n- Renewal evaluations\n- Risk management consulting"
          }
        }
      ]
    },
    {
      "name": "Property Intelligence",
      "description": "Property data, risk analysis, replacement cost, and flood assessment",
      "item": [
        {
          "name": "PROPERTY - Property Attributes",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"PROPERTY\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**PROPERTY Feature - Property Attributes & Valuation**\n\n**Returns:**\n- property: APN, owner, address, use code, street address\n- valuation: Price range (min/max)\n- assessment: Tax records including:\n  - Year built, building area, lot size\n  - Construction type, building condition\n  - Number of stories, units, bedrooms, baths\n  - Assessed values (land, improvement, total)\n  - Tax amount, market value\n- mortgageInfo: Loan details, lender, LTV\n\n**Use Cases:**\n- Property insurance quoting\n- Building valuation\n- Occupancy verification\n- Construction type determination"
          }
        },
        {
          "name": "RISK_PROPERTY - Property Risk Analysis",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"RISK_PROPERTY\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**RISK_PROPERTY Feature - Comprehensive Property Risk**\n\n**Returns 25+ Risk Categories:**\n- **Natural Hazards**: Wildfire, earthquake, flood, hail, tornado, hurricane, lightning\n- **Weather**: Wind region, drought, snow load, ice dam, frozen pipe\n- **Environmental**: Crime, superfund, brownfield, PFA, UST, radon, sinkhole, landslide\n- **Protection**: Fire protection class, hydrant distance, hospital distance, police station\n- **Climate**: Heating/cooling degree days, precipitation, temperature, snowfall\n- **FEMA**: Flood zones, FIRM panels, claims history, BCAT hazards\n- **Location**: Census block, state/county FIPS codes\n\n**Each risk includes:**\n- text: Human-readable description\n- score: Risk grade (A-F)\n- value/scale: Numeric risk metrics\n\n**Use Cases:**\n- CAT modeling\n- Premium rating\n- Risk assessment\n- Coverage determination"
          }
        },
        {
          "name": "REPLACEMENT - Building Replacement Cost",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"REPLACEMENT\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**REPLACEMENT Feature - Building Replacement Cost Analysis**\n\n**Returns:**\n- replacementCost: Total building replacement cost\n- replacementCostPersqfeet: Cost per square foot\n- contentsEstimate: Estimated contents value\n- demolitionCost: Demolition estimate\n- debrisRemovalCost: Debris removal estimate\n- estimatedBuilderProfit: Builder profit margin\n- Calculation factors:\n  - zipcodeFactor, squareFootageFactor\n  - buildingQualityFactor, buildingConditionFactor\n  - propertyUseBaseValue\n- Building details: Year built, construction type, stories, condition, use code\n\n**Use Cases:**\n- Property insurance limits\n- Building coverage amount\n- Contents coverage\n- Coinsurance compliance"
          }
        },
        {
          "name": "FLOOD - Flood Risk Assessment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"FLOOD\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**FLOOD Feature - Detailed Flood Risk Analysis**\n\n**Returns 40+ Data Points:**\n- floodZone: FEMA flood zone designation\n- riskScore: Overall flood risk (High, Medium, Low)\n- fldDistance: Distance to flood zone (feet)\n- riverDistance: Distance to nearest river (feet)\n- distanceToCoast: Distance to coast (feet)\n- elevation: Property elevation\n- ffh: First floor height\n- lag/hag: Lowest/highest adjacent grade\n- basement: Basement presence and confidence\n- Flood strategy recommendations (10-year, 30-year)\n- FEMA data: CBRS, coastal guidelines, awareness\n- Financial: Resilience gap, NFIP policy likelihood\n\n**Use Cases:**\n- Flood insurance quoting\n- NFIP compliance\n- Risk-based pricing\n- Coastal property assessment"
          }
        },
        {
          "name": "PROPERTY + RISK_PROPERTY + REPLACEMENT - Complete Property Package",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"PROPERTY,RISK_PROPERTY,REPLACEMENT,FLOOD\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Complete Property Intelligence Package**\n\n**Combines 4 Features:**\n- PROPERTY: Attributes, valuation, assessment, mortgage\n- RISK_PROPERTY: All natural and environmental hazards\n- REPLACEMENT: Building replacement cost analysis\n- FLOOD: Detailed flood risk and recommendations\n\n**Perfect for:**\n- Commercial property quoting\n- Building coverage analysis\n- CAT exposure evaluation\n- Comprehensive property underwriting"
          }
        }
      ]
    },
    {
      "name": "Safety & Compliance",
      "description": "OSHA safety data and DOT fleet/motor carrier information",
      "item": [
        {
          "name": "OSHA - Safety Compliance Data",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"enterprise\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_name\": \"Auxiliary Operations Resource\",\n  \"entity_city\": \"Plainfield\",\n  \"entity_state\": \"IN\",\n  \"features\": \"OSHA\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**OSHA Feature - Safety Compliance & Incident Data**\n\n**Returns:**\n- establishmentInfo:\n  - establishmentId, establishmentName, companyName\n  - EIN, NAICS code, industry description\n  - Match confidence and type\n- safetySummary (Annual OSHA 300A data):\n  - year, annualAverageEmployees, totalHoursWorked\n  - totalDeaths, totalDafwCases, totalDjtrCases\n  - totalDafwDays, totalDjtrDays\n  - breakdownByType: injuries, skin disorders, respiratory, poisonings, hearing loss\n- caseDetails (2024+ detailed incidents - 18 fields):\n  - caseNumber, yearFilingFor, dateOfIncident\n  - incidentOutcome, daysAwayFromWork, daysJobTransferRestriction\n  - jobDescription, SOC code, SOC probability\n  - PII-cleaned narratives: incident location, description, what happened, injury details\n- safetyMetrics (5-year data):\n  - trir5yr: Total Recordable Incident Rate\n  - dart5yr: Days Away/Restricted/Transferred rate\n  - totalCases5yr, totalHours5yr, yearsOfData\n\n**Use Cases:**\n- Workers compensation underwriting\n- Safety performance evaluation\n- Loss control assessment\n- Premium rating factors"
          }
        },
        {
          "name": "FMCD - DOT Fleet & Motor Carrier Data",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"enterprise\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_name\": \"LCF Delivery LLC\",\n  \"entity_city\": \"Pittsburgh\",\n  \"entity_state\": \"PA\",\n  \"features\": \"FMCD\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**FMCD Feature - Complete Fleet & Motor Carrier Data (DOT/FMCSA)**\n\n**CRITICAL: Insurance data is linked by docket_number**\n\n**DOT-Level Data:**\n- company_info (dot_company_census):\n  - dot_number, mcs150_date, legal_name, dba_name\n  - phone, fax, cell_phone, email\n  - business_address, mailing_address\n  - registration_date, status\n  - hm_ind (Hazmat indicator)\n  - docket1prefix/docket1, docket2prefix/docket2, docket3prefix/docket3\n  - match_confidence, match_type\n- fleet_info:\n  - total_drivers, total_cdl_drivers, power_units, truck_units, bus_units, total_cars\n  - fleetsize (A-Z code: A=0, B=1-2, C=3-5... Z=4001-5000+ units)\n  - mcs150_mileage, mcs150_mileage_year\n  - drivers_breakdown: interstate/intrastate (beyond/within 100 miles)\n  - owned_equipment, leased_equipment, trip_leased_equipment\n  - cargo_classification: 24 cargo types\n- safety_info (DOT-level umbrella):\n  - safety_rating (S/C/U), safety_rating_date\n  - last_review_date, review_type\n\n**Docket-Level Arrays (linked by docket_number):**\n- authorities[] - One per docket (can have up to 3 dockets):\n  - docket_number, prefix (MC/FF/BR), number\n  - mc_legal_name, mc_dba_name (may differ from census)\n  - common_authority, contract_authority, broker_authority\n  - applications_pending, revocation_pending\n- insurance_requirements[] - Per docket:\n  - docket_number, min_coverage_amount, cargo_required, bond_required\n  - bipd_on_file, cargo_on_file, bond_on_file\n- current_insurance[] - Active policies per docket:\n  - docket_number, ins_type_code (1=BIPD, 2=Cargo, 3=Bond, 4=Trust)\n  - ins_class_code (P/E), max_cov_amount, underl_lim_amount\n  - ins_form_code, policy_no, effective_date, name_company\n- previous_insurance[] - Historical policies per docket:\n  - docket_number, insurance_hist_id\n  - mod_col_1 (cancelled/replaced/name change/transferred)\n  - ins_cancl_form, mod_col_2 (BIPD indicator)\n  - effective_date, cancl_effective_date, cancl_method\n\n**Use Cases:**\n- Commercial auto underwriting (check authorities by docket)\n- Fleet insurance (review current_insurance by docket)\n- Motor carrier liability (assess safety_rating)\n- Insurance history analysis (track previous_insurance)\n- DOT compliance verification"
          }
        },
        {
          "name": "WORKCOMP - Workers Compensation Data",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"enterprise\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_name\": \"Lakeside Lumber Inc\",\n  \"entity_city\": \"Tualatin\",\n  \"entity_state\": \"OR\",\n  \"features\": \"WORKCOMP\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**WORKCOMP Feature - Workers Compensation Policy & Experience Data**\n\n**Returns:**\n- policy_info:\n  - policy_number, carrier_name, carrier_ncci_id\n  - carrier_address\n  - policy_effective_date, policy_expiration_date\n  - policy_cancellation_date, reinstatement_date\n  - end_reason\n- employer_info:\n  - employer_name, dba, fein\n  - address (street, city, state, zip)\n  - county, naics, employee_range\n  - number_of_locations, reporting_state\n- experience_data:\n  - experience_mod (experience modification factor)\n  - lost_cost, lcm (loss cost multiplier)\n  - vol_assigned_risk\n  - governing_class (WC class code)\n- coverage_details:\n  - match_type, match_confidence\n  - last_updated, source_table, source_database\n\n**Use Cases:**\n- Workers compensation underwriting\n- Experience mod verification\n- Premium calculation\n- Risk assessment\n- Carrier verification"
          }
        },
        {
          "name": "OSHA + FMCD - Complete Safety Package",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"enterprise\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_name\": \"Sample Trucking Company\",\n  \"entity_state\": \"PA\",\n  \"features\": \"OSHA,FMCD\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Complete Safety & Compliance Package**\n\n**Combines:**\n- OSHA: Workplace safety incidents and metrics\n- FMCD: DOT fleet and carrier compliance\n\n**Ideal for:**\n- Trucking companies\n- Fleet operations\n- Workers compensation + commercial auto\n- Safety performance evaluation"
          }
        }
      ]
    },
    {
      "name": "Complete Intelligence Examples",
      "description": "Full-featured examples combining multiple data sources",
      "item": [
        {
          "name": "Complete Classification Intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"FIRMO,BIZCORE\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Complete Classification Package**\n\n**Use Case:** Accurate business classification and firmographic data\n\n**Features:**\n- FIRMO: Complete firmographics with 50+ data points\n- BIZCORE: Ranked NAICS codes with confidence scores\n\n**Returns:**\n- Verified NAICS codes (primary + secondary)\n- ISO GL codes\n- Workers compensation codes\n- SIC codes\n- Revenue and employee data\n- Business description and keywords"
          }
        },
        {
          "name": "New Business Risk Intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"FIRMO,CVG,EXP,RISK,UWQ\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**New Business Risk Intelligence Package**\n\n**Use Case:** Complete underwriting for new business submissions\n\n**Features:**\n- FIRMO: Business firmographics and classification\n- CVG: Coverage recommendations\n- EXP: Exposure identification\n- RISK: Risk assessment by exposure with magnitude and mitigation\n- UWQ: Industry-specific underwriting questions\n\n**Solves:**\n- Incomplete applications\n- Misclassification\n- Coverage gaps\n- Missing risk information"
          }
        },
        {
          "name": "Renewal Intelligence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"premium\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"features\": \"FIRMO,CVG,EXP,RISK,OSHA\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Renewal Intelligence Package**\n\n**Use Case:** Policy renewal analysis and recommendations\n\n**Features:**\n- FIRMO: Updated firmographic data\n- CVG: Current coverage recommendations\n- EXP: Exposure changes\n- RISK: Current risk profile\n- OSHA: Latest safety performance data\n\n**Helps identify:**\n- Business changes affecting risk\n- Coverage gaps vs current exposures\n- Safety performance trends\n- Premium adjustment factors"
          }
        },
        {
          "name": "Complete Enterprise Intelligence - All Features",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enterprise_id\": \"{{ENTERPRISE_ID}}\",\n  \"access_package\": \"enterprise\",\n  \"session_id\": \"sess-{{$randomUUID}}\",\n  \"user_id\": \"postman_demo_user\",\n  \"search_type\": \"business\",\n  \"entity_id\": \"536734c7d63f9a25ef2a77dc262160d6a784bfa1\",\n  \"entity_name\": \"Thermal Dynamics Corporation\",\n  \"entity_address\": \"82 Benning St\",\n  \"entity_city\": \"West Lebanon\",\n  \"entity_state\": \"NH\",\n  \"features\": \"FIRMO,BIZCORE,CVG,EXP,RISK,UWQ,PROPERTY,RISK_PROPERTY,REPLACEMENT,FLOOD,FMCD,OSHA,WORKCOMP\"\n}"
            },
            "url": {
              "raw": "{{demoUrl}}/v1/linqConnect",
              "host": ["{{demoUrl}}"],
              "path": ["v1", "linqConnect"]
            },
            "description": "**Complete Enterprise Intelligence - All 13 Features**\n\n**ALL API responses use snake_case field naming**\n\n**Business Intelligence:**\n- FIRMO: Complete firmographics (70+ fields in additional_data)\n- BIZCORE: Ranked NAICS with confidence scores\n\n**Insurance Analysis:**\n- CVG: Coverage recommendations (recommended + additional)\n- EXP: Business exposures\n- RISK: Risk assessment with magnitude & mitigation\n- UWQ: Industry-specific underwriting questions\n\n**Property Intelligence:**\n- PROPERTY: Attributes, valuation, assessment, mortgage\n- RISK_PROPERTY: 100+ risk fields (enhanced storm params, FEMA data, crime, weather)\n- REPLACEMENT: Building replacement cost analysis\n- FLOOD: Detailed flood risk (40+ fields)\n\n**Safety & Compliance:**\n- OSHA: Safety data with 18-field case_details\n- FMCD: Complete DOT data with docket-level insurance tracking\n- WORKCOMP: Workers comp policy, experience mod, governing class\n\n**Use Cases:**\n- Complex commercial risks\n- Multi-line underwriting (GL + WC + Auto + Property)\n- Enterprise integrations\n- Comprehensive risk assessment"
          }
        }
      ]
    }
  ],
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// LinqConnect API Pre-request Script",
          "// Validates configuration and prepares request",
          "",
          "console.log('=== LinqConnect API Request ===');",
          "console.log('Demo API Key:', pm.variables.get('DEMO_API_KEY'));",
          "console.log('Enterprise ID:', pm.variables.get('ENTERPRISE_ID'));",
          "",
          "// Validate required variables",
          "const requiredVars = ['DEMO_API_KEY', 'ENTERPRISE_ID'];",
          "const missing = [];",
          "",
          "requiredVars.forEach(varName => {",
          "    if (!pm.variables.get(varName)) {",
          "        missing.push(varName);",
          "    }",
          "});",
          "",
          "if (missing.length > 0) {",
          "    console.error('❌ Missing required variables:', missing.join(', '));",
          "    console.log('📝 Set these in Collection Variables or Environment');",
          "}",
          "",
          "// Generate unique session ID",
          "const sessionId = 'sess-' + Date.now() + '-' + Math.random().toString(36).substr(2, 9);",
          "pm.variables.set('current_session_id', sessionId);",
          "",
          "console.log('Session ID:', sessionId);"
        ]
      }
    },
    {
      "listen": "test",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// LinqConnect API Test Script",
          "// Validates response structure and performance",
          "",
          "console.log('=== Response Validation ===');",
          "",
          "// Test: Status code",
          "pm.test('✅ Status code is 200', function () {",
          "    pm.response.to.have.status(200);",
          "});",
          "",
          "// Test: Response time",
          "pm.test('⚡ Response time < 5 seconds', function () {",
          "    pm.expect(pm.response.responseTime).to.be.below(5000);",
          "});",
          "",
          "// Test: Valid JSON",
          "pm.test('📄 Response is valid JSON', function () {",
          "    pm.response.to.be.json;",
          "});",
          "",
          "// LinqConnect specific tests",
          "if (pm.request.url.path.includes('linqConnect')) {",
          "    const jsonData = pm.response.json();",
          "    ",
          "    // Test metadata",
          "    pm.test('📋 Response has metadata', function () {",
          "        pm.expect(jsonData).to.have.property('metadata');",
          "        pm.expect(jsonData.metadata).to.have.property('status');",
          "        pm.expect(jsonData.metadata.status).to.equal('success');",
          "    });",
          "    ",
          "    // Test requested features are returned",
          "    if (pm.request.body && pm.request.body.raw) {",
          "        const requestBody = JSON.parse(pm.request.body.raw);",
          "        const features = requestBody.features.toLowerCase().split(',');",
          "        ",
          "        pm.test('✨ Requested features returned', function () {",
          "            features.forEach(feature => {",
          "                const featureMap = {",
          "                    'firmo': 'firmo',",
          "                    'bizcore': 'bizcore',",
          "                    'cvg': 'insuranceCoverage',",
          "                    'exp': 'keyExposures',",
          "                    'risk': 'riskAssessment',",
          "                    'uwq': 'underwritingQuestions',",
          "                    'property': 'propertyAttributes',",
          "                    'risk_property': 'propertyRisk',",
          "                    'replacement': 'replacementCost',",
          "                    'flood': 'flood',",
          "                    'osha': 'osha',",
          "                    'fmcd': 'fmcd'",
          "                };",
          "                ",
          "                const responseKey = featureMap[feature];",
          "                if (responseKey && feature !== 'uwq') {",
          "                    pm.expect(jsonData).to.have.property(responseKey);",
          "                }",
          "            });",
          "        });",
          "    }",
          "    ",
          "    // Log response summary",
          "    console.log('✅ Status:', jsonData.metadata.status);",
          "    console.log('📊 Features returned:', jsonData.metadata.features);",
          "    console.log('⏱️  Response time:', pm.response.responseTime + 'ms');",
          "}"
        ]
      }
    }
  ]
}