API-referens

Arbetsställen

Hämta företagets arbetsställen med CFAR-nummer, adresser och geografiska uppgifter.

GET /api/v1/companies/{company_id}/workplaces

Behörighet: Scope workplaces
Kostnad: 1 enhet för varje rad i svaret

Registret omfattar cirka 1,4 miljoner arbetsställen hos 772 000 företag. Varje post kan innehålla CFAR-nummer, post- och besöksadress, kommun, län, arbetsställets SNI-koder och storleksklass.

Parametrar

Parametrar som inte är markerade som obligatoriska kan utelämnas.

Namn	Typ	Så används fältet
`company_id` Obligatorisk I sökvägen	string	Företagets organisationsnummer med 10 siffror, med eller utan bindestreck, eller företagets publika token. Ett exakt personnummer fungerar när nyckeln har scope `person_lookup`.
`active`	boolean	Sätt till `true` för att endast visa aktiva arbetsställen. Standardvärde: `true`
`limit`	integer	Antal arbetsställen att returnera, från 1 till 500. Standardvärde: `500`

Anrop och svar

Exemplet visar en förfrågan mot produktionsmiljön och ett lyckat svar.

Förfrågan

curl "https://firmainfo.se/api/v1/companies/5560125790/workplaces?limit=1" \
  -H "Authorization: Bearer $FIRMAINFO_API_KEY"

Svar

{
  "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"
    }
  ]
}

Bra att veta

Med scope contacts kan juridiska personer även få fälten phone och email.

Fortsätt här

GET /companies/{company_id}/contact

Kontaktuppgifter

GET /companies/{company_id}/web

Digital närvaro