US Company Lookup (SEC EDGAR — by CIK, Ticker, or Name)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "cik"
      ]
    },
    {
      "required": [
        "company_name"
      ]
    },
    {
      "required": [
        "company"
      ]
    }
  ],
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC CIK number. Alternate to 'company' — same resolution rules apply."
    },
    "ticker": {
      "type": "string",
      "description": "Stock ticker symbol. Alternate to 'company' — same resolution rules apply."
    },
    "company": {
      "type": "string",
      "description": "CIK number, ticker symbol, or company name. Resolution order: exact CIK match, then exact ticker match, then exact company-name match (both via the SEC ticker/title map — no LLM call), then a best-effort LLM name extraction + SEC full-text filing search as a last resort (gated by match_confidence / allow_low_confidence below)."
    },
    "company_name": {
      "type": "string",
      "description": "US company name. Alternate to 'company' — same resolution rules apply."
    },
    "allow_low_confidence": {
      "type": "boolean",
      "default": false,
      "description": "If true, return the best-effort match even when the name could not be confidently resolved (match_confidence \"low\"). Default false — a low-confidence name lookup errors instead of returning a possibly-wrong company identity, so it can't silently feed downstream screening. Only relevant to the LLM+full-text-search fallback path; exact CIK/ticker/title-map resolutions are always match_confidence \"exact\" and are never gated by this flag."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key, zero-padded, e.g. '0000320193'."
    },
    "ein": {
      "type": "string",
      "description": "IRS Employer Identification Number on file with the SEC, digits only."
    },
    "sic": {
      "type": "string",
      "description": "SEC Standard Industrial Classification code."
    },
    "state": {
      "type": "string",
      "description": "US state abbreviation of the registered address."
    },
    "status": {
      "type": "string",
      "description": "e.g. 'active'."
    },
    "ticker": {
      "type": "string",
      "description": "Stock ticker, observed on the one publicly-listed company captured (Apple). A privately-held company resolved by CIK or name has not been observed and may not carry this field at all."
    },
    "address": {
      "type": "string",
      "description": "The company's registered address on file with the SEC, single-line."
    },
    "exchange": {
      "type": "string",
      "description": "Listing exchange, e.g. 'Nasdaq'. Same caveat as `ticker` -- only confirmed present for a publicly-listed company."
    },
    "error_code": {
      "type": "string",
      "description": "Present only on an unresolvable/not-found lookup, e.g. 'HTTP_400' for a company name that could not be matched to any SEC filer."
    },
    "entity_type": {
      "type": "string",
      "description": "e.g. 'operating'."
    },
    "company_name": {
      "type": "string",
      "description": "The resolved legal entity name."
    },
    "error_message": {
      "type": "string",
      "description": "Present only on an unresolvable/not-found lookup, a short human-readable explanation paired with `error_code`."
    },
    "searched_name": {
      "type": "string",
      "description": "Echoes the caller's own input search term back."
    },
    "is_exact_match": {
      "type": "boolean"
    },
    "fiscal_year_end": {
      "type": "string",
      "description": "MMDD, e.g. '0926' for a fiscal year ending September 26."
    },
    "sic_description": {
      "type": "string",
      "description": "Human-readable label for `sic`."
    },
    "match_confidence": {
      "type": "string",
      "description": "'exact' on the one real call observed (exact company-name match)."
    },
    "resolution_method": {
      "type": "string",
      "description": "Which resolution step matched, e.g. 'title' for the SEC title map."
    }
  },
  "description": "The company record, as returned at routing.responseResultPath ($.output). On an unresolvable/not-found lookup, only `error_code` and `error_message` are present instead of the company fields below.",
  "additionalProperties": true
}