Quickstart

Je eerste bedrijfsprofiel in vijf minuten.

Je hebt een account en een terminal nodig. Aan het eind heb je met een voorbeeldaanvraag het bedrijfsprofiel van Hetzner Online GmbH opgehaald en weet je wat het antwoord bevat.

Kopieer je API-sleutel

Maak een gratis account aan en bevestig je e-mailadres. Je krijgt 150 startcredits, 30 dagen geldig.

Je eerste API-sleutel staat al voor je klaar onder Account › API-sleutels. Kopieer hem en behandel hem als een wachtwoord.

Elke aanvraag stuurt de sleutel mee in de header x-api-key. In de voorbeelden staat daarvoor JOUW_API_SLEUTEL.

Antwoordt de API met 401, dan ontbreekt de sleutel of is hij niet volledig gekopieerd. Bij 403 is je e-mailadres nog niet bevestigd. De bevestigingslink vind je in je inbox.

Haal een bedrijfsprofiel op

Roep fetch-organization aan en geef de bedrijfsnaam mee in de parameter q. Zonder verdere parameters krijg je de basisgegevens voor 5 credits.

Kopieer de aanvraag, vul je sleutel in en voer haar uit. cURL toont de JSON direct. In Python en JavaScript staat het antwoord daarna in data. Met print(data["name"]) of console.log(data.name) zie je de bedrijfsnaam.

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

import requests

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

Lees het antwoord

Het antwoord is het bedrijfsprofiel als JSON. Dit zijn de velden die je het vaakst nodig hebt:

Lees het antwoord
Veld	Betekenis
entity_id	De ID van het bedrijf bij handelsregister.ai. Sla hem op voor vervolgaanvragen.
name, legal_form, status	Bedrijfsnaam, rechtsvorm en registerstatus, in het voorbeeld `ACTIVE`.
registration	Registerrechtbank, registertype en registernummer, in het voorbeeld Ansbach HRB 6089.
address, seat	Bedrijfsadres met coördinaten, plus de statutaire zetel volgens het register.
purpose, industry_classification	Doel van de onderneming en branche volgens WZ 2008 en WZ 2025.
representation_scheme	Vertegenwoordigingsregels: `current` geldt vandaag, `history` toont elke ingeschreven stand.
meta	Wat de aanvraag kostte (`request_credit_cost`) en je saldo daarna (`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 · Voorbeeldantwoord voor Hetzner Online GmbH, alleen basisgegevens

Met de entity_id vraag je hetzelfde bedrijf later direct op. Hij is ook de sleutel voor fetch-document en Signals. Registerrechtbank en registernummer zijn net zo eenduidig, in het voorbeeld Ansbach HRB 6089.

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

import requests

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

Hoe verder

Features toevoegen Bestuurders, aandeelhouders of financiën in dezelfde aanvraag. Een bedrijf op registernummer ophalen De eenduidige weg via registerrechtbank, registernummer en entity_id. Basisbegrippen Hoe credits, Realtime, historie en lege waarden werken. ChatGPT-plugin Dezelfde gegevens in een chat, zonder code. Python SDK De API in Python, met kant-en-klare methoden. Node SDK De API in JavaScript en TypeScript.