Company — Uppslag och sökning

Company-tjänsten är ett gränssnitt mot Bolagsverket med två endpoints: ett live-uppslag per företag och en snabb lokal sökning i det synkade företagsregistret. Båda kräver scopet company på din API-nyckel.

Live-uppslag via organisationsnummer

Hämtar den auktoritativa, dagsfärska företagsposten direkt från Bolagsverket:

curl -X POST https://sandbox-api.cerrtify.com/service/company/lookup \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{ "orgnr": "5599000105" }'

orgnr är ett svenskt 10-siffrigt organisationsnummer. Formaterad indata går bra — 559900-0105 och 559900 0105 normaliseras före uppslaget. Den 12-siffriga formen som sökningen svarar med (165599000105) går också bra. Allt annat returnerar 400 invalid_orgnr.

Svaret är Bolagsverkets JSON-post vidarebefordrad ordagrant, så strukturen följer deras schema för "Värdefulla datamängder". Testföretagen i sandbox returneras i samma format.

Fuzzy-sökning på namn (eller orgnr)

När du inte har ett organisationsnummer — till exempel i ett autocomplete-fält — sök i stället i det lokalt synkade registret. Det är snabbt och anropar inte Bolagsverket per request:

curl -X POST https://sandbox-api.cerrtify.com/service/company/search \
  -H "X-API-Key: cert_..." \
  -H "Content-Type: application/json" \
  -d '{ "q": "testbolaget", "limit": 5 }'

{
  "q": "testbolaget",
  "mode": "name",
  "count": 1,
  "limit": 5,
  "results": [
    {
      "orgnr": "165599000105",
      "name": "Testbolaget Nordic AB",
      "legal_form": "AB",
      "city": "Stockholm",
      "active": true,
      "score": 0.9,
      "sni_codes": ["62010", "58290"]
    }
  ]
}

Så fungerar matchningen:

• Om q är ett 10- eller 12-siffrigt tal tolkas det som ett orgnr och matchas exakt ("mode": "orgnr").
• I annat fall körs en fuzzy-matchning med prefix + trigram mot företagsnamn ("mode": "name"). Prefixträffar får poängen ~0.99; trigram-likhet ger poäng i intervallet 0–1.
• I sandbox matchar testföretagen på exakt org.nr eller valfri del av namnet (oavsett versaler); namnträffar får poängen 0.9.
• orgnr i resultatet anges i 12-siffrig form (företag har prefixet 16).

Alternativ i anropet:

Vilken ska du använda?

Använd search för autocomplete och för att slå upp orgnr utifrån namn; den serveras från ett lokalt index som synkas veckovis från Bolagsverkets bulkregister. Använd lookup när du behöver den auktoritativa live-posten för ett företag du redan har identifierat — onboarding-kontroller, KYB-flöden, ögonblicksbilder av registret.