Snabbstart

Din första företagsprofil på fem minuter.

Du behöver ett konto och en terminal. Till slut har du hämtat företagsprofilen för Hetzner Online GmbH med en exempelförfrågan, och du vet vad svaret innehåller.

Kopiera din API-nyckel

Skapa ett gratis konto och bekräfta din e-postadress. Du får 150 startkrediter, giltiga i 30 dagar.

Din första API-nyckel väntar redan på dig under Konto › API-nycklar. Kopiera den och behandla den som ett lösenord.

Varje förfrågan skickar nyckeln i headern x-api-key. Exemplen använder DIN_API_NYCKEL som platshållare för den.

Om API:et svarar med 401 saknas nyckeln eller så kopierades den inte helt. Vid 403 är din e-postadress ännu inte bekräftad. Bekräftelselänken hittar du i din inkorg.

Hämta en företagsprofil

Anropa fetch-organization och skicka företagsnamnet i parametern q. Utan fler parametrar får du grunddata för 5 krediter.

Kopiera förfrågan, sätt in din nyckel och kör den. cURL skriver ut JSON direkt. I Python och JavaScript ligger svaret sedan i data. Med print(data["name"]) eller console.log(data.name) ser du företagsnamnet.

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

import requests

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

Läs svaret

Svaret är företagsprofilen som JSON. Det här är fälten du behöver oftast:

Läs svaret
Fält	Betydelse
entity_id	Företagets ID hos handelsregister.ai. Spara det för följdförfrågningar.
name, legal_form, status	Företagsnamn, bolagsform och registerstatus, i exemplet `ACTIVE`.
registration	Registerdomstol, registertyp och registernummer, i exemplet Ansbach HRB 6089.
address, seat	Affärsadress med koordinater, plus det registrerade sätet enligt registret.
purpose, industry_classification	Verksamhetsföremål och bransch enligt WZ 2008 och WZ 2025.
representation_scheme	Företrädarregler: `current` gäller i dag, `history` visar varje registrerat tillstånd.
meta	Vad förfrågan kostade (`request_credit_cost`) och ditt saldo efteråt (`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 · Exempelsvar för Hetzner Online GmbH, bara grunddata

Med entity_id frågar du senare direkt efter samma företag. Det är också nyckeln för fetch-document och Signals. Registerdomstol och registernummer är lika unika, i exemplet Ansbach HRB 6089.

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

import requests

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

Vart du går härnäst

Lägg till funktioner Verkställande direktörer, delägare eller finanser i samma förfrågan. Hämta ett företag via registernummer Den unika vägen via registerdomstol, registernummer och entity_id. Grundbegrepp Hur krediter, Realtid, historik och tomma värden fungerar. ChatGPT-plugin Samma data i en chatt, helt utan kod. Python SDK API:et i Python, med färdiga metoder. Node SDK API:et i JavaScript och TypeScript.