Find companies
find_companiesFind private companies in the Corridome database in one call: under one NAICS code or a list of codes searched together, in one state or a list of states, by staff, years in business, PPP loan, and whether the records name an owner or officer with a phone or e-mail. Built from their public records: Form 5500, OSHA, SBA PPP and state registers, employers of 20 or more. Returns how many match (and how they split between the codes), and each company's id, name, place, NAICS code and industry, staff, formation date, PPP loan, the first owner or officer named, and which contacts its records give, the most staff first unless asked otherwise, with its corridome.com address. With include_contacts, it also returns the company's phone and e-mail and a named person's own work line where the records give one, using one credit from the account's monthly allowance for each company opened. Never search one code or one state at a time when the request names several: give them as lists. To choose codes from a description, call find_naics first.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Which page of results, from 1. | |
| sort | No | The order: staff (the most staff first), ppp (the largest PPP loan first), oldest or newest (by the day the state register says it was formed), name (A to Z). | staff |
| limit | No | How many results to return, 1 to 50. | |
| naics | No | One NAICS code, or a list of up to 12 searched together in this one call: ["237130", "238910", "237990"]. Each is 2 to 6 digits, matched as the start of a company's code: 23 is construction, 2382 building equipment contractors, 238220 plumbing and HVAC contractors. To choose codes from a description, call find_naics first. | |
| state | No | One state, or a list of up to 20 searched together in this one call, as two-letter codes: ["TX", "LA", "OK"]. | |
| industry | No | Words of the industry's NAICS title, when you don't have the code: plumbing, dental offices, trucking. They are matched to the likeliest code, which the result names, with the other codes that matched. | |
| max_staff | No | Most staff. | |
| min_staff | No | Fewest staff. Staff is the most the records count: a recent OSHA summary or a retirement plan's active participants, else the jobs a PPP loan reported. | |
| max_ppp_usd | No | The largest PPP loan, in US dollars. | |
| min_ppp_usd | No | The smallest PPP loan, in US dollars. Only companies with a PPP loan match. | |
| owner_as_filed | No | Only companies where a state register files someone as an owner, member or partner (never an officer, a director or a plan signer). | |
| include_contacts | No | Also return each company's phone and e-mail, and a named person's own work e-mail or phone, in its row. Each company whose contact is opened uses one credit from the account's monthly allowance, the same credits a person's contact uses; a company with no contact on file costs nothing, and one already opened this month is free. Use it only when the person asks for contact details, and say how many credits it used. Every row says which contacts are on file either way (contacts_on_file). | |
| include_staffing | No | Also return professional employer organizations and staffing firms. They are left out by default: their staff counts hold their clients' workers, so they lead every sector by size without being employers of that size. | |
| with_owner_contact | No | Only companies whose records name an owner or officer (an owner, member, partner, officer, principal, manager or governor on a state register) and give the company's phone or e-mail. | |
| with_person_contact | No | Only companies whose records give a named person's own work e-mail or phone: the employer's point of contact on its Department of Labor labor certification filings, with their job title. | |
| max_years_in_business | No | Fewer than this many years since the formation date. Only companies with a formation date match. | |
| min_years_in_business | No | At least this many years since the state register's formation date. Only companies with a formation date match. |