{
  "dataset": "Global Connect Hub business directory",
  "api_version": "v1",
  "base_url": "https://connecthubglobal.com/api/v1",
  "documentation_url": "https://connecthubglobal.com/developers",
  "agent_guide_url": "https://connecthubglobal.com/ai",
  "openapi_url": "https://connecthubglobal.com/api/v1/openapi.json",
  "mcp_endpoint": "https://connecthubglobal.com/mcp/public",
  "records": {
    "businesses_total": 2152,
    "from_official_register": 280,
    "from_web_aggregation": 1872,
    "field_level_claims": 10660
  },
  "last_change_at": null,
  "update_cadence": "Records are re-checked continuously by background sweeps; official-register lookups are performed on demand and cached with their own timestamp.",
  "confidence_model": {
    "high": "Official register, verified within the last 12 months.",
    "medium": "Official register older than 12 months, first-party site within 6 months, or two agreeing aggregated sources.",
    "low": "Single aggregated source, ageing first-party data, or a GCH-derived classification.",
    "disputed": "Sources disagree. Both values are returned; GCH does not pick a winner.",
    "unverified": "No source claim recorded for this field yet."
  },
  "limitations": [
    "GCH is not a government register and does not restate register data as its own findings.",
    "1872 of 2152 records originate from public web aggregation rather than an official register, and are labelled as such.",
    "Field-level provenance began when this API launched; older facts may only carry record-level provenance.",
    "`last_verified` appears only where a real re-check happened."
  ],
  "licence": "Public factual records may be retrieved and cited with attribution to the record's canonical URL. Third-party source content remains subject to the originating source's terms.",
  "rate_limit": {
    "requests": 120,
    "window_seconds": 60,
    "scope": "per IP, best-effort"
  },
  "contact": "https://connecthubglobal.com/developers",
  "endpoints": [
    {
      "path": "/api/v1/businesses",
      "description": "Search and filter business records."
    },
    {
      "path": "/api/v1/businesses/{id}",
      "description": "One record with field-level provenance."
    },
    {
      "path": "/api/v1/businesses/{id}/sources",
      "description": "Evidence behind each claim."
    },
    {
      "path": "/api/v1/businesses/{id}/regulatory",
      "description": "Register identifiers and cached register lookups."
    },
    {
      "path": "/api/v1/updates",
      "description": "Change feed with previous and current values."
    },
    {
      "path": "/api/v1/industries",
      "description": "Industry facets with counts."
    },
    {
      "path": "/api/v1/locations",
      "description": "Location facets with counts."
    },
    {
      "path": "/api/v1/meta",
      "description": "This document."
    },
    {
      "path": "/api/v1/openapi.json",
      "description": "OpenAPI 3.1 description."
    }
  ],
  "human_pages": {
    "directory": "https://connecthubglobal.com/directory",
    "record_example": "https://connecthubglobal.com/v/{slug}"
  }
}