Places of Performance API: where a company works

POSThttps://api.milda.ai/v1/companies/places-of-performance

Places of Performance

application/json

Description

Companies — Places of Performance

POST /v1/companies/places-of-performance

The countries a company operates in, and what it does in each one: production sites, subsidiaries, offices, delivered projects. The report is built from all the data Milda holds on the company, plus web research when the company's own content is thin.

Use this endpoint when a registered address is not enough: to check whether a supplier really has operations in a market, to route a lead to the right regional team, or to qualify companies by where they deliver rather than where they are incorporated.

Request

company_id (required) — Company ID.

Response

company_scope — single_country, multinational or unknown (not enough evidence)
default_country — primary/home country (English name) assumed for activities with no explicit location, usually the headquarters country; unknown when none can be justified
countries — list of countries the company operates in:
country — country name in English
summary — what the company does in that country
highlights — durable facts backing the summary (sites, subsidiaries, licences, long-running contracts)
sources — source URLs used for that country; empty when it came from the company's own content

Returns 204 No Content when no country of performance could be established.

Notes

The report is generated on demand and cached server-side (~6 months), so the first call for a company is slower than subsequent ones.

Credits

Charged a flat fee per company (data credits).

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.

Request body

CompanyInsightRequest

CompanyInsightRequesttypereq1 fields

company_idstringyesCompany ID.

Responses

200 Successful Response422 Validation Error

PlacesOfPerformancetype3 fields

company_scopestringGeographic scope of the company's operations: `single_country` (clearly operates in one country), `multinational` (operates in several) or `unknown` (not enough evidence).

default_countrystringPrimary/home country (English country name) assumed for activities that carry no explicit location, usually the headquarters country. `unknown` when no country can be justified.

+countriesPlaceOfPerformance[]Countries the company operates in and what it does in each.

countrystringCountry where the company performs activities (English country name).

summarystringWhat the company does in this country.

highlightsstring[]Durable facts backing the summary, such as sites, subsidiaries, licences or long-running contracts.

sourcesstring[]Source URLs used for this country. Empty when the country was derived from the company's own content.

POSThttps://api.milda.ai/v1/companies/places-of-performance