Datos básicos

Ejemplo

Los ejemplos de esta página proceden de una solicitud de ejemplo para Hetzner Online GmbH, Ansbach HRB 6089. Si su inscripción cambia, tu propia solicitud devuelve otros valores.

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();

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  "keywords": [12    "Dedicated Server",13    "Cloud Hosting",14    "Webhosting",15    "Colocation",16    "Object Storage",17    "Domainregistrierung",18    "SSL-Zertifikate",19    "Web-Hosting-Unternehmen"20  ],21  "products_and_services": [22    "Dedizierte Root-Server (Dedicated Servers)",23    "Cloud-Server und virtuelle Server",24    "Managed Server",25    "Webhosting (Shared Hosting)",26    "Colocation Rack / Rechenzentrumsflächen",27    "Storage Box / Object Storage / Storage Share",28    "Domain-Registrierung",29    "SSL-Zertifikate",30    "Load Balancer",31    "DNS Console",32    "Registration Robot",33    "Custom Solutions"34  ],35  "industry_classification": {36    "WZ2008": [37      {38        "code": "62.01.0",39        "label": "Erbringung von Dienstleistungen der Informationstechnologie"40      },41      {42        "code": "63.11.0",43        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44      },45      {46        "code": "61.90.0",47        "label": "Telekommunikation, sonstige"48      }49    ],50    "WZ2025": [51      {52        "code": "62.20.1",53        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54      },55      {56        "code": "46.50.1",57        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58      },59      {60        "code": "62.90.0",61        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62      }63    ]64  },65  "contact_data": {66    "website": "https://www.hetzner.com/",67    "phone_number": "09831 5050",68    "email": "[email protected]"69  },70  "address": {71    "house_number": "25",72    "street": "Industriestraße",73    "postal_code": "91710",74    "city": "Gunzenhausen",75    "county": "Weißenburg-Gunzenhausen",76    "state": "Bayern",77    "country": "DEU",78    "coordinates": {79      "latitude": 49.12483,80      "longitude": 10.7805281    }82  },83  "seat": {84    "city": "Gunzenhausen"85  },86  "registration_date": null,87  "representation_scheme": {88    "current": [89      "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."90    ],91    "history": [92      {93        "value": [94          "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."95        ],96        "effective_from": "2002-10-15",97        "effective_to": "2015-07-28"98      },99      {100        "value": [101          "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."102        ],103        "effective_from": "2015-07-28",104        "effective_to": null105      }106    ]107  },108  "capital": {109    "current": {110      "amount": 50000,111      "currency": "EUR",112      "kind": "STAMMKAPITAL"113    },114    "history": [115      {116        "value": {117          "amount": 50000,118          "currency": "EUR",119          "kind": "GRUNDKAPITAL"120        },121        "effective_from": "2002-10-15",122        "effective_to": null123      }124    ]125  },126  "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.",127  "meta": {128    "request_credit_cost": 5,129    "credits_remaining": 145130  }131}

200 · Respuesta de ejemplo: los datos básicos de Hetzner Online GmbH, Ansbach HRB 6089

Nombre y forma jurídica

Nombre, forma jurídica y estado describen la empresa; la entity_id la identifica. Guarda la entity_id si quieres volver a obtener o vigilar una empresa más tarde, o vincularla con tus propios datos.

Campo
Campo	Significado	Ejemplo	Disponibilidad
entity_idstring	El ID de la empresa en handelsregister.ai. Guárdalo como clave en tus datos. En el parámetro q coincide exactamente con esta empresa.Datos básicos	`"94eb910fef13f94585c48c263fa446d4"`	siempre
namestring	Nombre de la empresa tal como figura en el registro, con el sufijo de su forma jurídica.	`"Hetzner Online GmbH"`	como arriba
legal_formstring	Forma jurídica, normalmente como la abreviatura alemana habitual. Compara sin distinguir mayúsculas y minúsculas, porque la grafía puede variar ligeramente, por ejemplo oHG. Con el modo IA puede aparecer la forma completa. La lista muestra valores habituales; hay más.Valores: `GmbH` Gesellschaft mit beschränkter Haftung (sociedad de responsabilidad limitada), `UG (haftungsbeschränkt)` Unternehmergesellschaft (mini GmbH), `AG` Aktiengesellschaft (sociedad anónima), `SE` Societas Europaea (sociedad anónima europea), `KGaA` Kommanditgesellschaft auf Aktien (sociedad comanditaria por acciones), `GmbH & Co. KG` KG con una GmbH como socio colectivo, `KG` Kommanditgesellschaft (sociedad comanditaria), `OHG` Offene Handelsgesellschaft (sociedad colectiva), `e.K.` eingetragener Kaufmann (comerciante individual inscrito), `eG` eingetragene Genossenschaft (cooperativa inscrita), `PartG` Partnerschaftsgesellschaft (sociedad profesional), también con responsabilidad profesional limitada, `e.V.` eingetragener Verein (asociación inscrita), `eGbR` eingetragene Gesellschaft bürgerlichen Rechts (sociedad civil inscrita)	`"GmbH"`	como arriba
statusstring	Estado registral de la empresa. Son posibles otros valores; trata los valores desconocidos como “no activa”.Valores: `ACTIVE` activa, `INSOLVENT` en procedimiento de insolvencia, `DISSOLVED` disuelta, en liquidación, `TERMINATED` cancelada en el registro	`"ACTIVE"`	como arriba

Inscripción registral

Tribunal registral, tipo de registro y número de registro identifican una empresa. Los escribimos juntos, en nuestro ejemplo como “Ansbach HRB 6089”. También puedes pasarlos de esta forma en el parámetro q.

Campo
Campo	Significado	Ejemplo	Disponibilidad
registrationobject\|null	La inscripción registral de la empresa.Vacío cuando el modo IA solo conoce una empresa por fuentes web; su entity_id empieza entonces por AI_TMP_Datos básicos	–	siempre
registration.courtstring	Tribunal registral como nombre de lugar, sin “Amtsgericht” (juzgado local), por ejemplo Ansbach o Charlottenburg (Berlin).	`"Ansbach"`	como arriba
registration.register_typestring	Tipo de registro, es decir, el registro y, en el Handelsregister, su sección.Valores: `HRB` Handelsregister sección B: GmbH, UG, AG, SE, KGaA, `HRA` Handelsregister sección A: e.K., OHG, KG, GmbH & Co. KG, `GnR` Genossenschaftsregister (registro de cooperativas), `PR` Partnerschaftsregister (registro de sociedades profesionales), `VR` Vereinsregister (registro de asociaciones), `GsR` Gesellschaftsregister (registro de sociedades) para la eGbR	`"HRB"`	como arriba
registration.register_numberstring	Número de registro como texto. Solo es único junto con el tribunal registral y el tipo de registro.	`"6089"`	como arriba
registration_datestring\|null	Fecha de inscripción en el registro, como marca de tiempo ISO 8601.Vacío cuando la fecha no consta	`"2013-03-18T00:00:00+00:00"`	casi siempre: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG rara vez: GmbH & Co. KG, e.K.

Un número de registro solo es único junto con su tribunal registral. Muchos tribunales pueden tener el mismo número.

Dirección y domicilio social

address es la dirección comercial, seat el domicilio social (Sitz) en el registro. Ambos pueden diferir, por ejemplo cuando una empresa está inscrita en Múnich y trabaja en Gauting.

Campo
Campo	Significado	Ejemplo	Disponibilidad
addressobject	Dirección comercial de la empresa.Datos básicos	–	siempre
address.streetstring\|null	Calle sin número.Vacío cuando la dirección consta solo de la ciudad	`"Industriestraße"`	casi siempre
address.house_numberstring\|null	Número como texto, también con sufijo como “6 a”.Vacío cuando la dirección no tiene número	`"25"`	como arriba
address.postal_codestring\|null	Código postal como texto, para conservar los ceros iniciales.Vacío cuando la dirección consta solo de la ciudad	`"91710"`	como arriba
address.citystring	Ciudad de la dirección comercial.	`"Gunzenhausen"`	siempre
address.countystring	Distrito (Landkreis) o ciudad independiente. Falta como clave en algunas direcciones.	`"Weißenburg-Gunzenhausen"`	casi siempre
address.statestring	Estado federado (Bundesland). Falta como clave en algunas direcciones.	`"Bayern"`	como arriba
address.countrystring	País como código ISO 3166 de tres letras, por ejemplo DEU. Falta como clave en algunas direcciones.	`"DEU"`	como arriba
address.coordinatesobject	Coordenadas geográficas de la dirección comercial, para mapas y búsquedas por radio.	–	como arriba
address.coordinates.latitudenumber\|null	Latitud en grados decimales.Vacío cuando la dirección no se pudo geocodificar	`49.12483`	como arriba
address.coordinates.longitudenumber\|null	Longitud en grados decimales.Vacío cuando la dirección no se pudo geocodificar	`10.78052`	como arriba
seatobject	El domicilio social (Sitz) de la empresa en el registro.	–	siempre
seat.citystring	Ciudad del domicilio social. Puede diferir de la dirección comercial.	`"Gunzenhausen"`	como arriba

Objeto social y sector

El objeto social (Unternehmensgegenstand) figura en el registro para GmbH, UG, AG, SE, KGaA, eG y PartG. GmbH & Co. KG, KG, OHG y comerciantes individuales (e.K.) no inscriben objeto social. Sector, palabras clave y productos y servicios existen para cualquier forma jurídica.

Campo
Campo	Significado	Ejemplo	Disponibilidad
purposestring\|null	Objeto social tal como figura en el registro, en alemán. Con el modo IA es un breve resumen de la actividad, también para formas jurídicas sin objeto social inscrito.Vacío cuando la forma jurídica no inscribe objeto social, por ejemplo KG, OHG y e.K.Datos básicos	`"Die Durchführung von Internet- und Netzwerkdienstleistun…"`	siempre: GmbH, UG, AG, SE, KGaA, eG, PartG nunca: GmbH & Co. KG, KG, OHG, e.K.
industry_classificationobject	Sector según la clasificación alemana de actividades económicas (WZ), en dos versiones.	–	siempre
industry_classification.WZ2025array	Códigos de sector según WZ 2025, la versión actual. El filtro de sector de la búsqueda también usa estos códigos.Vacío cuando no se pudo asignar ningún sector	–	casi siempre
industry_classification.WZ2025[].codestring	Código WZ de cinco dígitos, por ejemplo 62.20.1.	`"62.20.1"`	como arriba
industry_classification.WZ2025[].labelstring	Nombre de la actividad económica, en alemán.	`"Erbringung von Beratungsleistungen auf dem Gebiet der In…"`	como arriba
industry_classification.WZ2008array	Códigos de sector según la versión anterior WZ 2008, para sistemas que aún la usan.Vacío cuando no existe asignación WZ 2008	–	a veces
industry_classification.WZ2008[].codestring	Código WZ de cinco dígitos según WZ 2008.	`"62.01.0"`	como arriba
industry_classification.WZ2008[].labelstring	Nombre de la actividad económica, en alemán.	`"Erbringung von Dienstleistungen der Informationstechnolo…"`	como arriba
keywordsarray	Palabras clave sobre la actividad de la empresa, recopiladas de fuentes web públicas. Ampliadas con el modo IA.Vacío cuando la empresa tiene poca presencia en la web	–	como arriba
products_and_servicesarray	Los productos y servicios de la empresa como lista, recopilados de fuentes web públicas. Ampliados con el modo IA.Vacío cuando la empresa tiene poca presencia en la web	–	como arriba

Con el modo IA, purpose contiene un breve resumen de la actividad en lugar del texto del registro. El modo IA añade palabras clave y productos y servicios de la web.

Capital

Las sociedades de capital inscriben su capital social (Stammkapital o Grundkapital), cada cambio con su fecha. current es el importe vigente, history los cambios en orden cronológico. Las sociedades de personas y los comerciantes individuales no tienen capital fijo; ahí current es null y history está vacío.

Campo
Campo	Significado	Ejemplo	Disponibilidad
capitalobject	Capital inscrito con su historial.Datos básicos	–	siempre
capital.currentobject\|null	El importe de capital vigente.Vacío cuando la forma jurídica no inscribe capital fijo, por ejemplo KG, OHG, e.K. y PartG	–	siempre: GmbH, UG, AG, SE, KGaA rara vez: eG nunca: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.current.amountnumber	Importe como número, en la moneda de currency.	`50000`	como arriba
capital.current.currencystring	Moneda como código ISO 4217, casi siempre EUR.	`"EUR"`	como arriba
capital.current.kindstring	Tipo de capital. Son posibles otros valores.Valores: `STAMMKAPITAL` Stammkapital (capital social) de una GmbH o UG, `GRUNDKAPITAL` Grundkapital (capital social) de una AG, SE o KGaA, `LIABILITY_SUM` Haftsumme (suma de responsabilidad), por ejemplo de una cooperativa, `CONDITIONAL` capital condicional de una AG, en inscripciones anteriores	`"STAMMKAPITAL"`	como arriba
capital.historyarray	Todos los importes inscritos en orden cronológico, incluido el vigente.	–	como arriba
capital.history[].valueobject	El importe con amount, currency y kind, estructurado como current.	–	como arriba
capital.history[].value.change_amountobject	Importe del cambio según la inscripción registral, con amount y currency. Si el capital se aumentó o se redujo se deduce comparándolo con el importe anterior.	–	a veces: AG, SE, KGaA rara vez: GmbH, UG, eG nunca: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_fromstring\|null	Vigente desde este día, en el formato YYYY-MM-DD.	`"2002-10-15"`	siempre: GmbH, UG, AG, SE, KGaA rara vez: eG nunca: GmbH & Co. KG, KG, OHG, e.K., PartG
capital.history[].effective_tostring\|null	Vigente hasta este día.Vacío cuando el importe sigue vigente	`"2005-02-28"`	como arriba

Leemos automáticamente el historial de capital de las inscripciones registrales. Para ello usamos la tecnología más actual e invertimos mucho en calidad; aun así, pueden darse errores puntuales.

Reglas de representación

Las reglas de representación (Vertretungsregelung) definen quién puede actuar por la empresa. La respuesta las contiene literalmente del registro, en alemán. En nuestra solicitud de ejemplo para Hetzner Online GmbH, el historial nombraba al consejo de dirección (Vorstand) hasta el 28 de julio de 2015 y después a los administradores. Las facultades de cada persona están en Poder de representación.

Campo
Campo	Significado	Ejemplo	Disponibilidad
representation_schemeobject	Reglas generales de representación de la empresa con su historial.Datos básicos	–	siempre: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG casi siempre: AG, SE, KGaA, e.K.
representation_scheme.currentarray\|null	Las reglas vigentes como lista de párrafos de texto, literalmente del registro.Vacío cuando no hay reglas inscritas	–	como arriba
representation_scheme.historyarray	Todas las versiones inscritas con su vigencia, incluida la vigente.	–	como arriba
representation_scheme.history[].valuearray	El texto de esta versión como lista de párrafos.	–	como arriba
representation_scheme.history[].effective_fromstring\|null	Vigente desde este día, en el formato YYYY-MM-DD.	`"2002-10-15"`	como arriba
representation_scheme.history[].effective_tostring\|null	Vigente hasta este día.Vacío cuando la versión sigue vigente	`"2015-07-28"`	como arriba

Con Tiempo real, history está vacío. La versión vigente está en current.

Contacto y web

Los datos de contacto no están en el registro. Los recopilamos de la web de la empresa. Que existan depende, por tanto, de lo que la empresa publique en la web.

Campo
Campo	Significado	Ejemplo	Disponibilidad
contact_dataobject	Datos de contacto de la web de la empresa.Datos básicos	–	siempre
contact_data.websitestring\|null	Dirección de la web.Vacío cuando no se encontró ninguna web	`"https://www.hetzner.com/"`	a veces
contact_data.phone_numberstring\|null	Número de teléfono tal como lo publica la empresa. El formato no está normalizado.Vacío cuando no se encontró ningún número	`"09831 5050"`	como arriba
contact_data.emailstring\|null	Dirección de email general de la empresa.Vacío cuando no se encontró ninguna dirección	`"[email protected]"`	como arriba
website_contentstring\|null	El texto de la web como Markdown, por ejemplo para tu propio análisis o un modelo de lenguaje. Llega con la función website_content, solo junto con el modo IA y sin coste adicional.Vacío cuando no se encontró ninguna web`website_content`	`"Dedicated Servers, Cloud & Hosting from Germany \| Hetzne…"`	como arriba

Tiempo real

Con realtime_mode=handelsregister-default, la API consulta además el Handelsregister en directo. La respuesta contiene entonces las personas inscritas actualmente y _realtime_mode con el resultado de la consulta. Tiempo real solo se cobra si la consulta tiene éxito, pero entonces independientemente de lo que devuelva.

Campo
Campo	Significado	Ejemplo	Disponibilidad
_realtime_modeobject	Resultado de la consulta con Tiempo real. Solo está en la respuesta si pediste realtime_mode.Datos básicos	–	siempre
_realtime_mode.modestring	El modo solicitado, handelsregister-default.	`"handelsregister-default"`	como arriba
_realtime_mode.statusstring	Si la consulta en directo tuvo éxito. Con cualquier otro valor, la respuesta contiene los datos guardados, y Tiempo real no se cobra.Valores: `success` consulta en directo correcta, los datos vienen directamente del Handelsregister	`"success"`	como arriba

Una consulta con Tiempo real tarda más, así que configura el timeout de tu cliente en al menos 120 segundos. Si la consulta en directo falla, la API devuelve los datos guardados. _realtime_mode.status no es entonces success, y Tiempo real no se cobra. Si la solicitud tarda demasiado, recibes 408 sin coste; vuelve a intentarlo más tarde.

fetch-organization El endpoint que devuelve los datos básicos, con parámetros y errores. Personas y representación Administradores, Prokura y socios con sus facultades. Conceptos básicos Cómo leer current e history, null y listas vacías. Disponibilidad de datos Qué contiene el registro por forma jurídica y de dónde vienen los datos.