Hurtigstart

Din første firmaprofil på fem minutter.

Du trenger en konto og en terminal. Til slutt har du hentet firmaprofilen til Hetzner Online GmbH med en eksempelforespørsel, og du vet hva svaret inneholder.

Kopier API-nøkkelen din

Opprett en gratis konto og bekreft e-postadressen din. Du får 150 startkreditter, gyldige i 30 dager.

Den første API-nøkkelen din venter allerede under Konto › API-nøkler. Kopier den og behandle den som et passord.

Hver forespørsel sender nøkkelen i headeren x-api-key. Eksemplene bruker YOUR_API_KEY som plassholder for den.

Svarer API-et med 401, mangler nøkkelen eller ble ikke kopiert helt. Med 403 er e-postadressen din ikke bekreftet ennå. Bekreftelseslenken finner du i innboksen din.

Hent en firmaprofil

Kall fetch-organization og send firmanavnet i parameteren q. Uten flere parametere får du grunndataene for 5 kreditter.

Kopier forespørselen, sett inn nøkkelen din og kjør den. cURL skriver ut JSON-en direkte. I Python og JavaScript ligger svaret deretter i data. Med print(data["name"]) eller console.log(data.name) ser du firmanavnet.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

Les svaret

Svaret er firmaprofilen som JSON. Dette er feltene du trenger oftest:

Les svaret
Felt	Betydning
entity_id	Firmaets ID hos handelsregister.ai. Lagre den for oppfølgingsforespørsler.
name, legal_form, status	Firmanavn, selskapsform og registerstatus, i eksempelet `ACTIVE`.
registration	Registerdomstol, registertype og registernummer, i eksempelet Ansbach HRB 6089.
address, seat	Forretningsadresse med koordinater, pluss forretningskontoret ifølge registeret.
purpose, industry_classification	Formål og bransje etter WZ 2008 og WZ 2025.
representation_scheme	Representasjonsregler: `current` gjelder i dag, `history` viser hver registrert tilstand.
meta	Hva forespørselen kostet (`request_credit_cost`) og saldoen din etterpå (`credits_remaining`).

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "industry_classification": {12    "WZ2008": [13      {14        "code": "62.01.0",15        "label": "Erbringung von Dienstleistungen der Informationstechnologie"16      },17      {18        "code": "63.11.0",19        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20      },21      {22        "code": "61.90.0",23        "label": "Telekommunikation, sonstige"24      }25    ],26    "WZ2025": [27      {28        "code": "62.20.1",29        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30      },31      {32        "code": "46.50.1",33        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34      },35      {36        "code": "62.90.0",37        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38      }39    ]40  },41  "address": {42    "house_number": "25",43    "street": "Industriestraße",44    "postal_code": "91710",45    "city": "Gunzenhausen",46    "county": "Weißenburg-Gunzenhausen",47    "state": "Bayern",48    "country": "DEU",49    "coordinates": {50      "latitude": 49.12483,51      "longitude": 10.7805252    }53  },54  "seat": {55    "city": "Gunzenhausen"56  },57  "registration_date": null,58  "representation_scheme": {59    "current": [60      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."61    ],62    "history": [63      {64        "value": [65          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."66        ],67        "effective_from": "2002-10-15",68        "effective_to": "2015-07-28"69      },70      {71        "value": [72          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."73        ],74        "effective_from": "2015-07-28",75        "effective_to": null76      }77    ]78  },79  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",80  "meta": {81    "request_credit_cost": 5,82    "credits_remaining": 14583  }84}

200 · Eksempelsvar for Hetzner Online GmbH, bare grunndata

Med entity_id spør du senere direkte etter det samme firmaet. Den er også nøkkelen for fetch-document og Signals. Registerdomstol og registernummer er like entydige, i eksempelet Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "q": "94eb910fef13f94585c48c263fa446d4",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

Veien videre

Legg til funksjoner Daglige ledere, eiere eller økonomi i samme forespørsel. Hent et firma via registernummer Den entydige veien via registerdomstol, registernummer og entity_id. Grunnbegreper Hvordan kreditter, Sanntid, historikk og tomme verdier fungerer. ChatGPT-plugin De samme dataene i en chat, helt uten kode. Python SDK API-et i Python, med ferdige metoder. Node SDK API-et i JavaScript og TypeScript.