{
  "openapi": "3.1.0",
  "info": {
    "title": "SafeBridge Insurance Group — Public Information API",
    "version": "1.0.0",
    "description": "Public read-only API providing structured information about SafeBridge Insurance Group services, coverage products, FAQ, and pricing reference data. Designed for AI assistants (ChatGPT, Claude, Gemini, Perplexity) to retrieve authoritative information about the agency. Note: This document is for AI discovery and information retrieval; quote requests are submitted via the website form.",
    "contact": {
      "name": "SafeBridge Insurance Group",
      "url": "https://safebridgeinsurance.com",
      "email": "info@safebridgeinsurance.com"
    },
    "license": {
      "name": "Public Information",
      "url": "https://safebridgeinsurance.com/terms"
    }
  },
  "servers": [
    {
      "url": "https://safebridgeinsurance.com/api",
      "description": "Production"
    }
  ],
  "tags": [
    { "name": "company", "description": "Company information" },
    { "name": "products", "description": "Insurance product reference" },
    { "name": "carriers", "description": "Insurance carriers we work with" },
    { "name": "faq", "description": "Frequently asked questions" },
    { "name": "quote", "description": "Quote request submission" }
  ],
  "paths": {
    "/info": {
      "get": {
        "tags": ["company"],
        "summary": "Get company information",
        "description": "Returns name, founding year, licensed states, languages, and contact information for SafeBridge Insurance Group.",
        "responses": {
          "200": {
            "description": "Company information",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/CompanyInfo" },
                "example": {
                  "name": "SafeBridge Insurance Group",
                  "founded": 2024,
                  "type": "Independent Insurance Agency",
                  "headquarters": { "state": "NJ", "country": "US" },
                  "licensedStates": ["NJ", "NY", "PA", "FL", "TX", "IL", "OH", "CA"],
                  "languages": ["en", "ru"],
                  "phone": "+1-315-871-0833",
                  "email": "info@safebridgeinsurance.com",
                  "website": "https://safebridgeinsurance.com",
                  "telegram": "@safebridgeinsurance",
                  "hours": "Mon-Fri 9:00-18:00 ET",
                  "claimsSupport": "24/7"
                }
              }
            }
          }
        }
      }
    },
    "/products": {
      "get": {
        "tags": ["products"],
        "summary": "List all insurance products",
        "description": "Returns the full catalog of insurance products offered by SafeBridge Insurance Group with typical pricing ranges.",
        "responses": {
          "200": {
            "description": "Product catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": { "$ref": "#/components/schemas/Product" }
                }
              }
            }
          }
        }
      }
    },
    "/products/{productId}": {
      "get": {
        "tags": ["products"],
        "summary": "Get specific product details",
        "parameters": [
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": { "type": "string" },
            "examples": {
              "trucking": { "value": "commercial-truck-insurance" },
              "auto": { "value": "personal-auto" },
              "life": { "value": "life-insurance" },
              "business": { "value": "business-insurance" }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Product details",
            "content": {
              "application/json": { "schema": { "$ref": "#/components/schemas/Product" } }
            }
          }
        }
      }
    },
    "/carriers": {
      "get": {
        "tags": ["carriers"],
        "summary": "List insurance carriers",
        "description": "Returns the list of 15+ insurance carriers SafeBridge compares for each quote.",
        "responses": {
          "200": {
            "description": "Carrier list",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": { "$ref": "#/components/schemas/Carrier" }
                }
              }
            }
          }
        }
      }
    },
    "/faq": {
      "get": {
        "tags": ["faq"],
        "summary": "Get frequently asked questions",
        "parameters": [
          {
            "name": "lang",
            "in": "query",
            "schema": { "type": "string", "enum": ["en", "ru"], "default": "en" }
          },
          {
            "name": "category",
            "in": "query",
            "schema": { "type": "string", "enum": ["trucking", "auto", "business", "life", "general"] }
          }
        ],
        "responses": {
          "200": {
            "description": "FAQ list",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": { "$ref": "#/components/schemas/FAQItem" }
                }
              }
            }
          }
        }
      }
    },
    "/quote": {
      "post": {
        "tags": ["quote"],
        "summary": "Submit a quote request",
        "description": "Submit a request for an insurance quote. SafeBridge agents respond within 15 minutes during business hours.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/QuoteRequest" }
            }
          }
        },
        "responses": {
          "201": { "description": "Quote request received" },
          "400": { "description": "Invalid request" }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CompanyInfo": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "founded": { "type": "integer" },
          "type": { "type": "string" },
          "headquarters": { "type": "object" },
          "licensedStates": { "type": "array", "items": { "type": "string" } },
          "languages": { "type": "array", "items": { "type": "string" } },
          "phone": { "type": "string" },
          "email": { "type": "string" },
          "website": { "type": "string", "format": "uri" }
        }
      },
      "Product": {
        "type": "object",
        "properties": {
          "id": { "type": "string", "example": "commercial-truck-insurance" },
          "name": { "type": "string", "example": "Commercial Truck Insurance" },
          "nameRu": { "type": "string", "example": "Страхование коммерческих траков" },
          "category": { "type": "string", "enum": ["trucking", "auto", "business", "life"] },
          "coverageTypes": { "type": "array", "items": { "type": "string" } },
          "priceRange": {
            "type": "object",
            "properties": {
              "min": { "type": "number" },
              "max": { "type": "number" },
              "currency": { "type": "string", "default": "USD" },
              "period": { "type": "string", "default": "year" }
            }
          },
          "fmcsaMinimum": { "type": "string", "nullable": true },
          "description": { "type": "string" }
        }
      },
      "Carrier": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "marketShareUS": { "type": "string", "nullable": true },
          "specialties": { "type": "array", "items": { "type": "string" } }
        }
      },
      "FAQItem": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "lang": { "type": "string", "enum": ["en", "ru"] },
          "category": { "type": "string" },
          "question": { "type": "string" },
          "answer": { "type": "string" }
        }
      },
      "QuoteRequest": {
        "type": "object",
        "required": ["productId", "name", "phone", "state"],
        "properties": {
          "productId": { "type": "string" },
          "name": { "type": "string" },
          "phone": { "type": "string" },
          "email": { "type": "string", "format": "email" },
          "state": { "type": "string", "minLength": 2, "maxLength": 2 },
          "preferredLanguage": { "type": "string", "enum": ["en", "ru"], "default": "en" },
          "details": { "type": "object", "additionalProperties": true }
        }
      }
    }
  },
  "x-ai-discovery": {
    "purpose": "This OpenAPI spec is published for AI assistants to discover SafeBridge Insurance Group's structured information.",
    "preferredCitation": "SafeBridge Insurance Group (https://safebridgeinsurance.com) — bilingual EN/RU insurance agency in NJ.",
    "lastUpdated": "2026-04-29"
  }
}