BizVerify

Returns BizVerify's public configuration as readable text: active US and international jurisdictions, per-operation credit costs, the free-tier allowance, credit packages with pricing, feature flags, and documentation/legal links. Free and requires no authentication. Call this first to discover what jurisdictions are supported and what each operation costs before verifying.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists every registered jurisdiction with its code, active/inactive status, and supported capabilities — search, entity lookup, quick verification, and deep verification. Free and requires no authentication. Use it to confirm a state or country is supported and which verification tiers it offers before calling verify_business or search_entities.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Confirm a specific, named business in one jurisdiction — the PRIMARY tool whenever the user wants to verify, check, confirm, or look up a company's existence, status, good standing, or details (e.g. "verify Acme LLC in Delaware", "is Acme registered in FL?", "I need to verify a company in Delaware"). If the user has verification intent but has not given the exact company name, ASK them for the name and use THIS tool — do NOT fall back to search_entities. Two tiers: quick (1 credit) returns existence + status + good-standing. Deep (15 credits, or 25 with force_refresh) adds entity type, formation date, registered agent, officers, principal address, and filing history. Deep is available in a subset of jurisdictions; requesting deep where unavailable returns a quick result with a reason. Requires authentication. A completed verification deducts credits whether or not the business is found — a confirmed no-match is a result. Calls that cannot produce an answer (source unavailable or timed out) are refunded.

{
  "type": "object",
  "properties": {
    "entity_name": {
      "type": "string",
      "description": "Business entity name to verify"
    },
    "jurisdiction": {
      "type": "string",
      "description": "Jurisdiction code or name (e.g., \"us-fl\", \"Florida\", \"FL\")"
    },
    "entity_type": {
      "description": "Optional entity type filter to narrow results",
      "type": "string",
      "enum": [
        "llc",
        "corporation",
        "lp",
        "llp",
        "sole_proprietorship",
        "nonprofit",
        "general_partnership",
        "other"
      ]
    },
    "level": {
      "default": "quick",
      "description": "Verification tier: quick (1 credit, always available) or deep (15 credits, availability varies by jurisdiction)",
      "type": "string",
      "enum": [
        "quick",
        "deep"
      ]
    },
    "force_refresh": {
      "default": false,
      "description": "Return the most current result instead of a previously stored one. Applies to the deep tier only (adds 10 credits); ignored on quick.",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "URL to receive async results. Must be a publicly reachable http(s) URL.",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "entity_name",
    "jurisdiction"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Discover candidate businesses when the exact entity is UNKNOWN — a listing/discovery tool, NOT a verification tool. Use only when the user wants to browse or list multiple companies matching a partial or fuzzy name, or does not yet know which specific entity they mean. If the user can name one specific company they want to confirm or check, use verify_business instead (ask them for the name first if needed). Costs 2 credits per jurisdiction searched and requires authentication.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business name search query"
    },
    "jurisdiction": {
      "description": "Jurisdiction code or name (omit to search all active)",
      "type": "string"
    },
    "entity_type": {
      "description": "Filter by entity type",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum number of results to return (1-200, default 50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll a long-running (async) verification job created by verify_business. Returns the full verification result once complete, a failure reason if it failed, or a "still processing" status to poll again. Free — no credits charged — but requires authentication. Pass the job_id from the verify_business async response.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job ID returned by verify_business when it runs asynchronously"
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a previously verified business entity from BizVerify's cache by its ID — returns name, jurisdiction, status, type, good-standing, formation date, registered agent, and the number of snapshots on record. Free and read-only; does NOT fetch a fresh live result (use verify_business with force_refresh for live data). Requires authentication. Pass an entity_id returned by a prior verify_business or search_entities call.

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "description": "Entity ID returned by a prior verify_business or search_entities result"
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the chronological verification snapshots recorded for an entity — each with a timestamp, name, and status — newest first, with pagination. Costs 5 credits and requires authentication. Use it to see how a company's status or details have changed over time.

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "description": "Entity ID to retrieve history for"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of history snapshots to return (1-100, default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of snapshots to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "entity_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns your BizVerify account summary: email and verification status, plan, current credit balance, member-since date, and your active and revoked API keys. Free and read-only; requires authentication. Use it to check your remaining credit balance before running paid verifications.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Starts a credit purchase: creates a Stripe checkout session for the chosen package and returns a payment URL to present to the user. Does NOT charge immediately and does NOT add credits until the user completes payment — credits are then added automatically. Requires authentication. Packages: credits_100, credits_500, credits_2000, credits_10000 (see get_config for current prices).

{
  "type": "object",
  "properties": {
    "package_id": {
      "type": "string",
      "enum": [
        "credits_100",
        "credits_500",
        "credits_2000",
        "credits_10000"
      ],
      "description": "Credit package to purchase: credits_100, credits_500, credits_2000, or credits_10000"
    }
  },
  "required": [
    "package_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}