Resolve company ID
Companies
Resolve company ID
Resolve a batch of alternate identifiers — domain, website, LinkedIn URL, or company name — into the Specter company id. Re-use that id with the id-only company endpoints such as Get company by ID.
This endpoint is free — resolving identifiers to IDs uses no credits. The id-only endpoints you call next are charged as usual.
Behaviour
- Pass identifiers under
to_resolve(1–50 per request). Each entry must carry exactly one identifier; none, or more than one, returns a validation error. - The response has one result group per input, in the same order, so you can attribute each set of matches back to what you sent.
queryechoes the normalized identifier. domainmatches the primary domain and any domain aliases;website_urlis reduced to its domain before matching.- Exact identifiers (
domain,website_url,linkedin_url) return at most one company, withmatch_confidence1. nameis fuzzy-matched and can return several ranked candidates (at most 10). Each carries amatch_confidencefrom 0 to 1, relative to the other results for that query; use the extra fields (domain, HQ, founded year) to pick the right one.- An identifier that matches nothing keeps its place with an empty
matcheslist.
POST
Resolve company ID
Authorizations
Body
application/json
The identifiers to resolve.
Required array length:
1 - 50 elementsResponse
One result group per input identifier, in the same order as to_resolve.