POST
https://api.milda.ai/v1/companies/lookupLookup
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:
- 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) — maximum number of matches to return.
Response
companies— list of matching companies (SearchCompany), ranked by match quality.search_id— identifier for this search.
Returns 204 No Content if no company matches.
Credits
Charged a flat fee per lookup (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
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
CompanyLookupResponsetypereq2 fields
+companiesLookupCompany[]yes
company_idstringyesUnique identifier for the company.
namestring | null—Full name of the company.
urlstring | null—URL of the company's official website.
country_codeCountryCode | null—Company's country, as a two-letter ISO 3166-1 alpha-2 code.
sizeSize | null—Company size category based on employee count.
search_idstringyes