{
  "openapi": "3.1.0",
  "info": {
    "title": "VerifyGrid B2B Verification & Compliance REST API + Remote MCP Server",
    "version": "1.0.0",
    "description": "Sub-50ms phone TCPA/DNC, FMCSA USDOT/MC carrier authority, CMS NPPES NPI provider, SEC EDGAR corporate entity, and OFAC/OIG sanctions verification backed by Cloudflare D1 and live federal registries.",
    "contact": {
      "name": "VerifyGrid API Support",
      "url": "https://www.verifygrid.io",
      "email": "api@verifygrid.io"
    }
  },
  "servers": [
    {
      "url": "https://www.verifygrid.io",
      "description": "VerifyGrid Global Edge Gateway"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "summary": "Edge gateway and D1/KV health status",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Healthy response"
          }
        }
      }
    },
    "/v1/keys/sandbox": {
      "post": {
        "summary": "Provision an instant vg_test_... sandbox API key with 50 free credits",
        "operationId": "createSandboxKey",
        "responses": {
          "200": {
            "description": "Provisioned sandbox API key"
          }
        }
      }
    },
    "/v1/verify/carrier": {
      "get": {
        "summary": "Verify FMCSA USDOT/MC carrier operating authority, insurance, BOC-3, and 2027 UCR",
        "operationId": "verifyCarrier",
        "parameters": [
          {
            "name": "dot",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2247805"
            }
          },
          {
            "name": "mc",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Carrier authority verification payload"
          }
        }
      }
    },
    "/v1/verify/provider": {
      "get": {
        "summary": "Verify 10-digit Healthcare NPI provider via D1 cache and live CMS NPPES API",
        "operationId": "verifyProvider",
        "parameters": [
          {
            "name": "npi",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "1245319599"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Healthcare NPI provider payload"
          }
        }
      }
    },
    "/v1/verify/sanctions": {
      "get": {
        "summary": "Screen entity or individual against OFAC SDN, HHS OIG LEIE, SAM.gov, and EPA ECHO",
        "operationId": "verifySanctions",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "Acme Global Holdings"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "US"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Sanctions screening payload"
          }
        }
      }
    },
    "/v1/verify/telecom": {
      "get": {
        "summary": "Validate phone E.164, NANPA line type, carrier OCN, and TCPA DNC / serial litigator status",
        "operationId": "verifyTelecom",
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "+14155550199"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Telecom & TCPA verification payload"
          }
        }
      }
    },
    "/v1/verify/entity": {
      "get": {
        "summary": "Verify SEC EDGAR CIK, incorporation state, SIC code, and corporate standing",
        "operationId": "verifyEntity",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "Apple Inc"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "DE"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Corporate entity verification payload"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "JSON-RPC 2.0 Streamable HTTP Remote MCP Server (initialize, tools/list, tools/call)",
        "operationId": "handleMcpRpc",
        "responses": {
          "200": {
            "description": "JSON-RPC 2.0 response"
          }
        }
      }
    }
  }
}