Inicio rápido

Tu primer perfil de empresa en cinco minutos.

Necesitas una cuenta y una terminal. Al final habrás obtenido el perfil de empresa de Hetzner Online GmbH con una solicitud de ejemplo y sabrás qué contiene la respuesta.

Copia tu clave API

Crea una cuenta gratuita y confirma tu dirección de email. Recibes 150 créditos iniciales, válidos durante 30 días.

Tu primera clave API ya te espera en Cuenta › Claves API. Cópiala y trátala como una contraseña.

Cada solicitud envía la clave en el header x-api-key. Los ejemplos usan TU_CLAVE_API en su lugar.

Si la API responde con 401, falta la clave o no se copió completa. Con 403, tu dirección de email aún no está confirmada. El enlace de confirmación está en tu bandeja de entrada.

Obtén un perfil de empresa

Llama a fetch-organization y pasa el nombre de la empresa en el parámetro q. Sin más parámetros obtienes los datos básicos por 5 créditos.

Copia la solicitud, inserta tu clave y ejecútala. cURL imprime el JSON directamente. En Python y JavaScript la respuesta queda en data. Con print(data["name"]) o console.log(data.name) ves el nombre de la empresa.

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

import requests

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

Lee la respuesta

La respuesta es el perfil de empresa como JSON. Estos son los campos que más vas a necesitar:

Lee la respuesta
Campo	Significado
entity_id	El ID de la empresa en handelsregister.ai. Guárdalo para solicitudes posteriores.
name, legal_form, status	Nombre de la empresa, forma jurídica y estado registral, en el ejemplo `ACTIVE`.
registration	Tribunal registral, tipo de registro y número de registro, en el ejemplo Ansbach HRB 6089.
address, seat	Dirección comercial con coordenadas, más el domicilio social según el registro.
purpose, industry_classification	Objeto social y sector según WZ 2008 y WZ 2025.
representation_scheme	Reglas de representación: `current` rige hoy, `history` muestra cada estado inscrito.
meta	Lo que costó la solicitud (`request_credit_cost`) y tu saldo después (`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 · Respuesta de ejemplo para Hetzner Online GmbH, solo datos básicos

Con la entity_id consultas más tarde la misma empresa directamente. También es la clave para fetch-document y Signals. Tribunal registral y número de registro son igual de únicos, en el ejemplo Ansbach HRB 6089.

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

import requests

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

Cómo seguir

Añadir funciones Administradores, socios o finanzas en la misma solicitud. Obtener una empresa por número de registro El camino único mediante tribunal registral, número de registro y entity_id. Conceptos básicos Cómo funcionan los créditos, Tiempo real, el historial y los valores vacíos. Plugin de ChatGPT Los mismos datos en un chat, sin código. Python SDK La API en Python, con métodos listos. Node SDK La API en JavaScript y TypeScript.