POST
https://api.milda.ai/v1/companies/lookupFind Company
application/json01
Description
Find Company
POST /v1/companies/lookup
Look up a specific company by its name, website, or registration number. Use this when you already know the company you want and need to resolve it to a company id, rather than running a broad topical search.
Request
Provide at least one identifier. If you send several, one is used: the registration
number if given, otherwise the website, otherwise the name.
- name — company name.
- website — company website or domain name.
- registration_number — company registration number.
- country_code (optional) — restrict the lookup to a country (ISO 3166-1 alpha-2).
- limit (optional, default 10) — maximum number of matches to return.
Response
companies— list of matching companies, best match first. Each hascompany_id,name,url,country_codeandsize.search_id— identifier for this search.
Returns 204 No Content if no company matches.
Credits
1 data credit per lookup that finds a company.
02
Headers
nameinreqdescription
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03
Request body
CompanyLookupItemCompanyLookupItemtypereq5 fields
namestring | null—Company name to look up.
websitestring | null—Company website or domain name to look up.
registration_numberstring | null—Company registration number to look up.
country_codeCountryCode | null—Restrict the lookup to companies headquartered in this country (ISO 3166-1 alpha-2 code).
limitinteger—Maximum number of matching companies to return.min 0 · default 10
04
Responses
200 Successful Response422 Validation Error
CompanyLookupResponsetype2 fields
+companiesLookupCompany[]
company_idstringUnique identifier for the company.
namestring | nullFull name of the company.
urlstring | nullURL of the company's official website.
country_codeCountryCode | nullCompany's country, as a two-letter ISO 3166-1 alpha-2 code.
sizeSize | nullCompany size category based on employee count.
search_idstring