companies

Find US businesses by name when you do not yet know which one you want. Full-text ranked search over 30.6M entities from 56 state and territory registries. Use it to browse candidates or check whether a name exists at all; use private_resolve instead when you need to identify one specific company. Note: this matches NAMES. There is no industry classification in the search itself, so "roofing" returns companies named "Roofing ...", not every roofer — use private_list with a naics filter for that.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business name or partial name to search"
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. FL, NY, CA, TX. 56 jurisdictions covered."
    },
    "type": {
      "type": "string",
      "description": "Filter by entity type: domestic_profit, domestic_llc, domestic_lp, foreign_profit, domestic_nonprofit"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 25, max 200)",
      "default": 25
    }
  },
  "required": [
    "query"
  ]
}

You have already identified a company and now need the full official record: current status, incorporation date, EIN, registered agent, every officer with their role, addresses, and filing history. This is the record a state government actually holds, so use it to settle questions that web sources disagree about — mirrors frequently report stale status or the wrong registered agent.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. FL, NY, CA, TX"
    },
    "state_id": {
      "type": "string",
      "description": "State entity ID (FL: Corporation Number, NY: DOS ID)"
    }
  },
  "required": [
    "state",
    "state_id"
  ]
}

Find which companies a named person is an officer, director or registered agent of. Use it to check whether a counterparty is who they claim, to map the other entities behind one operator, or to find every company a person controls before signing with any of them. Covers 21.2M officer records.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Officer/CEO name or partial name"
    },
    "title": {
      "type": "string",
      "description": "Filter by title: ceo, president, director, secretary, treasurer, vp, chairman, manager"
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. FL, NY, CA, TX"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 25)",
      "default": 25
    }
  },
  "required": [
    "name"
  ]
}

Build a list of companies matching criteria rather than looking one up: state, industry (NAICS), entity type, age, city, ZIP. Use it for prospecting, market sizing, or finding every business of a kind in a place. Ask for an industry with the naics filter — 23 is construction, 238 specialty trades, 238160 roofing.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. FL, NY, CA, TX"
    },
    "type": {
      "type": "string",
      "description": "Entity type: domestic_profit, domestic_llc, domestic_lp, foreign_profit"
    },
    "min_age": {
      "type": "number",
      "description": "Minimum business age in years"
    },
    "max_age": {
      "type": "number",
      "description": "Maximum business age in years"
    },
    "city": {
      "type": "string",
      "description": "City name (partial match)"
    },
    "zip": {
      "type": "string",
      "description": "ZIP code prefix"
    },
    "county": {
      "type": "string",
      "description": "County (NY only)"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 25)",
      "default": 25
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset",
      "default": 0
    }
  }
}

Find the chief executive, president, chairman or manager behind a company, or find every company a named executive runs. Use when the question is "who is actually in charge here" rather than "does this company exist". Restricted to executive-level titles; use private_officer_search for any role including directors and secretaries.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "CEO/president name to search"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 25)",
      "default": 25
    }
  },
  "required": [
    "name"
  ]
}

Find businesses where an officer is also the registered agent — the filing lists the same person in both roles. This is a succession and acquisition signal: it usually means an owner-operated company with no management layer. Use it to build acquisition target lists or to judge whether a supplier depends on one person. It indicates what the filing says, not legal ownership or control.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. FL, NY, CA, TX"
    },
    "min_age": {
      "type": "number",
      "description": "Minimum business age (default 15)",
      "default": 15
    },
    "type": {
      "type": "string",
      "description": "Entity type filter"
    },
    "city": {
      "type": "string",
      "description": "City filter"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 50)",
      "default": 50
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset",
      "default": 0
    }
  }
}

Check what this dataset actually covers before relying on it. Returns per-state record counts AND the government source behind each state, which matters: some states are full business registries with officer records, while others (California, Illinois) hold only federal SAM.gov registrants with no officer data at all. Read this before asking who runs a company in a state you have not used before.

{
  "type": "object",
  "properties": {}
}

Get business age distribution — how many entities are 0-4, 5-9, 10-14, 15-19, 20-29, 30-39, 40+ years old. Optionally filter by state.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Filter by state: FL, NY"
    }
  }
}

Geographic distribution of private businesses. Group by city, zip, county, or state. Shows where businesses are concentrated.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Filter by state"
    },
    "group_by": {
      "type": "string",
      "description": "Group by: city, zip, county, state",
      "default": "city"
    },
    "limit": {
      "type": "number",
      "description": "Top N locations (default 30)",
      "default": 30
    }
  }
}

Entity type breakdown — how many domestic profit corps, LLCs, LPs, nonprofits, foreign corps, etc. Optionally filter by state.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Filter by state: FL, NY"
    }
  }
}

Resolve a messy or partial business name to ONE canonical government record, with a computed confidence score (0-1), an ambiguity flag and ranked alternatives. Use this when you have a company name from a document, email or user message and need to identify the actual registered entity. Prefer this over private_search when the goal is identification rather than browsing. If confidence is below 0.6, show the user the alternatives instead of choosing one.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business name as you have it, however messy"
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code to narrow the search, e.g. FL"
    },
    "city": {
      "type": "string",
      "description": "City, used as a corroborating signal"
    }
  },
  "required": [
    "query"
  ]
}

What has actually CHANGED about one company, with the date we observed each change and cryptographic proof. State registries publish only current values and keep no history, so this answers questions no registry lookup can: did this company change its registered agent, did its status change, was it renamed. Accepts a messy name or an exact state + state_id. Returns a human-readable page URL you can cite. Change history covers CO, CT, NY and TX; for other states the response says so rather than returning an empty list.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, however messy. Resolved to one record, with the confidence reported."
    },
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. NY"
    },
    "state_id": {
      "type": "string",
      "description": "The registry id, if you already have it"
    },
    "limit": {
      "type": "number",
      "description": "Max changes to return (default 50, max 200)"
    }
  }
}

Companies that changed recently, across a state or a field — for finding corporate events rather than looking one company up. A registered-agent change signals a sale, restructuring or change of counsel; a status change is the difference between a live prospect and a dissolved one. Filter by state, by field (status, status_reason, agent_name, entity_name, principal_city, principal_state) and by date. Each row carries proof bytes and a citable page. Covers CO, CT, NY, TX.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code to narrow to, e.g. TX"
    },
    "field": {
      "type": "string",
      "description": "One of: status, status_reason, agent_name, entity_name, principal_city, principal_state"
    },
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD; only changes observed on or after this date"
    },
    "limit": {
      "type": "number",
      "description": "Max rows (default 50, max 500)"
    }
  }
}