Up to 100 company ids, domains or company LinkedIn URLs. One input matches at most one company.
Look up companies
POST
/companies/lookupTakes up to 100 company ids, domains or company LinkedIn URLs and returns the matching company records. The result keeps the input order, one result per input. You pay one contact credit for each match, and a miss costs nothing. Each matched input costs one contact credit, including repeated inputs. A domain matches a company that carries it among its domains. A LinkedIn URL reduces to its company page.
Contact creditsOne contact credit per match. A miss costs nothing.Takes up to 100 company ids, domains or company LinkedIn URLs and returns the matching company records. The result keeps the input order, one result per input. You pay one contact credit for each match, and a miss costs nothing. Each matched input costs one contact credit, including repeated inputs. A domain matches a company that carries it among its domains. A LinkedIn URL reduces to its company page.
Request body
inputsarray of stringrequired
Response
The fields inside data. One result per input, in the same order as the request.
inputstringrequired
The identifier exactly as the request sent it.
matchedbooleanrequired
True when we hold the company. You pay one contact credit for each match, and a miss costs nothing.
companyCompany or nullrequired
The matched company, or null on a miss.
reasonenumoptional
Present when the input is not a company id, a domain or a company LinkedIn URL. Such an input returns no company and costs nothing.
invalid
Failures
| Status | Meaning |
|---|---|
| 400 | The request shape, a filter key, a value, a cursor or the enrichment mode was rejected. |
| 401 | The credential is missing, unknown or revoked. |
| 402 | The daily or the monthly contact credit cap is spent, or the free plan's lifetime pool is. |
| 429 | The key passed 300 requests a minute or 2 concurrent requests. |
| 503 | The data is unavailable for a short time. |
| 504 | The query passed its time budget and was stopped. |
Docs for agents: llms.txt