Kom hurtigt i gang

Din første virksomhedsprofil på fem minutter.

Du skal bruge en konto og en terminal. Til sidst har du hentet virksomhedsprofilen for Hetzner Online GmbH med en eksempelforespørgsel, og du ved, hvad svaret indeholder.

Kopiér din API-nøgle

Opret en gratis konto, og bekræft din e-mailadresse. Du får 150 startkreditter, gyldige i 30 dage.

Din første API-nøgle venter allerede på dig under Konto › API-nøgler. Kopiér den, og behandl den som en adgangskode.

Hver forespørgsel sender nøglen i headeren x-api-key. Eksemplerne bruger DIN_API_NOEGLE som pladsholder for den.

Svarer API’et med 401, mangler nøglen, eller den blev ikke kopieret helt. Ved 403 er din e-mailadresse endnu ikke bekræftet. Bekræftelseslinket finder du i din indbakke.

Hent en virksomhedsprofil

Kald fetch-organization, og angiv virksomhedens navn i parameteren q. Uden yderligere parametre får du grunddataene for 5 kreditter.

Kopiér forespørgslen, indsæt din nøgle, og kør den. cURL udskriver JSON direkte. I Python og JavaScript står svaret derefter i data. Med print(data["name"]) eller console.log(data.name) ser du virksomhedens navn.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Læs svaret

Svaret er virksomhedsprofilen som JSON. Det er de felter, du oftest har brug for:

Læs svaret
Felt	Betydning
entity_id	Virksomhedens ID hos handelsregister.ai. Gem det til opfølgende forespørgsler.
name, legal_form, status	Virksomhedens navn, selskabsform og registerstatus, i eksemplet `ACTIVE`.
registration	Registerret, registertype og registernummer, i eksemplet Ansbach HRB 6089.
address, seat	Forretningsadresse med koordinater, plus hjemstedet ifølge registret.
purpose, industry_classification	Formål og branche efter WZ 2008 og WZ 2025.
representation_scheme	Tegningsregler: `current` gælder i dag, `history` viser hver registreret tilstand.
meta	Hvad forespørgslen kostede (`request_credit_cost`), og din saldo bagefter (`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, kun grunddata

Med entity_id forespørger du senere den samme virksomhed direkte. Det er også nøglen til fetch-document og Signals. Registerret og registernummer er lige så entydige, i eksemplet Ansbach HRB 6089.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "DIN_API_NOEGLE"},
    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": "DIN_API_NOEGLE" },
});
const data = await response.json();

Hvor du går videre

Tilføj features Direktører, ejere eller regnskabstal i samme forespørgsel. Hent en virksomhed via registernummer Den entydige vej via registerret, registernummer og entity_id. Grundbegreber Sådan fungerer kreditter, Realtid, historik og tomme værdier. ChatGPT-plugin De samme data i en chat, helt uden kode. Python SDK API’et i Python, med færdige metoder. Node SDK API’et i JavaScript og TypeScript.