API reference
Workplaces
Retrieve a company's workplaces with CFAR numbers, addresses and geographic data.
- Access
-
Scope
workplaces - Cost
- 1 unit per row in the response
The register covers around 1.4 million workplaces across 772,000 companies. Each record can carry a CFAR number, postal and visiting address, municipality, county, the workplace's own SNI industry codes and its size class.
Parameters
Parameters not marked as required may be omitted.
| Name | Type | What the field does |
|---|---|---|
company_id
Required
|
string |
The company's ten-digit registration number, with or without the hyphen, or the company's public token. An exact personal identity number works when the key holds the person_lookup scope.
|
active
|
boolean |
Set to true to show only active workplaces.
Default: true
|
limit
|
integer |
How many workplaces to return, from 1 to 500.
Default: 500
|
Request and response
The example shows a request against the production environment and a successful response.
curl "https://firmainfo.se/api/v1/companies/5560125790/workplaces?limit=1" \
-H "Authorization: Bearer $FIRMAINFO_API_KEY"{
"company": { "id": "5560125790", "name": "Aktiebolaget Volvo", "registration_number": "556012-5790" },
"count": 1,
"has_more": false,
"data": [
{
"cfar": "19540321",
"name": "Aktiebolaget Volvo",
"is_headquarters": true,
"type": "Huvudkontor",
"active": true,
"postal_address": { "care_of": "", "street": "", "postal_code": "405 08", "city": "GÖTEBORG" },
"visiting_address": { "street": "Gropegårdsgatan 2", "postal_code": "417 15", "city": "GÖTEBORG" },
"municipality": { "code": "1480", "name": "Göteborg" },
"county": { "code": "14", "name": "Västra Götalands län" },
"industry_codes": ["70100"],
"employees_interval": "500-999 anställda",
"coordinates": { "lat": 57.7156, "lon": 11.9231 },
"start_date": "1994-01-01"
}
]
}Good to know
-
With the
contactsscope, legal entities can also carry thephoneandemailfields.