What a response looks like
{"count": 1, "items": [{ "query": "Costco"} ]}| query |
|---|
| Costco |
Example rows from the API documentation.
What it returns
One stable ID per company across public records. Give a company name, ticker, SEC CIK or EIN and get back its company ID, legal name, former names, tickers and exchanges, EIN, industry (SIC), state of incorporation, headquarters city and state, website, whether it files 13F reports, how many 13F managers hold it, and how many records each source holds under its name.
IDs are c-<CIK> for every company that files with the SEC (402,795 companies, funds and managers) and n-<name key> for a business known only from state and local records. The ID links:
- SEC EDGAR: CIK, current and former names, tickers, EIN, SIC, state of incorporation.
- 13F holdings: the issuer CUSIP each manager reports, mapped to the company.
- State business registries: New York, Colorado, Oregon, Connecticut and Texas.
- State licenses: professional, contractor and business licenses from 8 states (CO, CT, DE, IL, NY, OR, TX, WA).
- Federal court cases: new civil and criminal cases from federal district and bankruptcy courts.
- Federal award notices: SAM.gov contract award notices.
- Local government contracts: city and county award notices.
Matching is by normalized legal name with the suffix kept (Acme LLC and Acme Inc. stay apart), so a record links only when its name spells the same company. Names of individuals are never linked. Rebuilt weekly.
Request
POST https://api.pushbuild.com/company-id-lookup/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
query | string | Company name, ticker (COST), SEC CIK (909832), EIN (91-1223280) or a company ID (c-909832). |
queries | list of strings | Up to 100 names, tickers or IDs in one run. |
maxCandidates | integer | How many possible matches to return for an ambiguous name. Default: 5. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/company-id-lookup/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Costco", "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 records. No charge for errors or empty searches.
| Records | Cost |
|---|---|
| 1,000 | $0.80 |
| 10,000 | $8.00 |
| 100,000 | $80.00 |
| 1,000,000 | $800.00 |
| 1,250 a month | Free ($1 monthly credit) |
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/company-id-lookup. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comWant this data inside your own app or CRM? API integrations and data sync