Hoppa till innehåll
Meny och API-referens

API-referens

Sök företag

Sök och filtrera företag efter plats, bransch, storlek och finansiella värden.

GET /api/v1/companies
Behörighet
Scope companies
Kostnad
1 enhet för varje rad i svaret

Kombinera registeruppgifter och ekonomiska mått i samma urval. Intervallfilter ska använda motsvarande sortering. Till exempel kräver revenue_min att du skickar sort=revenue. Det håller svarstiden stabil även för stora urval.

Välj sortering

VärdeOrdningKan kombineras med
revenue (standard)Omsättning, fallanderevenue_min / revenue_max
employeesAntal anställda, fallandeemployees_min / employees_max
registeredRegistreringsdatum, fallanderegistered_after / registered_before
nameFöretagsnamn, A till ÖInga intervallfilter

Parametrar

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

NamnTypSå används fältet
sort
string Bestämmer ordningen och vilka intervallfilter du kan använda. Standardvärde: revenue
limit
integer Välj hur många rader sidan ska innehålla, från 1 till 100. Standardvärde: 25
cursor
string Fortsätt från next_cursor i föregående svar.
active
boolean Sätt till true för aktiva företag eller false för övriga.
status
string active, dissolved, inactive.
legal_form
string Bolagsform, t.ex. AB, HB, EK.
city
string Matcha en exakt postort. Versaler och gemener behandlas lika.
county
string SCB:s tvåsiffriga länskod, till exempel 14 för Västra Götaland.
municipality
string SCB:s fyrsiffriga kommunkod.
sni
string Matcha en exakt femsiffrig SNI-kod.
employees_class
string SCB:s tvåsiffriga storleksklass för antal anställda.
has_financials
boolean Begränsa urvalet till företag med minst ett bokslut.
listed
boolean Begränsa urvalet till börsnoterade företag.
revenue_min / revenue_max
integer Nedre eller övre gräns för omsättning i SEK. Kräver sort=revenue.
employees_min / employees_max
integer Nedre eller övre gräns för antal anställda. Kräver sort=employees.
registered_after / registered_before
date Registrering efter eller före ett ISO-datum. Kräver sort=registered.

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?county=14&revenue_min=100000000&limit=2" \
  -H "Authorization: Bearer $FIRMAINFO_API_KEY"
Svar
{
  "data": [
    {
      "id": "5560125790",
      "name": "Aktiebolaget Volvo",
      "registration_number": "556012-5790",
      "legal_form": "AB",
      "status": "active",
      "city": "GÖTEBORG",
      "sni_primary": "70100",
      "registration_date": "1915-05-05",
      "financials_latest": {
        "fiscal_year_end": "2024-12-31",
        "revenue": 526816000000,
        "profit": 55215000000,
        "employees": "97923.00"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ2IjoxLCJzIjoicmV2ZW51ZSIsImYiOiI4YzE..."
}

Bra att veta

  • En okänd query-parameter ger 422, så ett stavfel kan inte passera obemärkt.
  • Markören är signerad och knuten till dina filter. Om filtren ändras under pagineringen får du 400 cursor_conflict.
  • Ett urval kan bläddras i högst 400 sidor. Kontakta oss om du behöver ett större, återkommande uttag.

Fortsätt här