# German Company Registry Lookup (Handelsregister)

> German Company Registry Lookup (Handelsregister) is a paid API for AI agents from companies.use.x402atlas.com, paid per call via x402, $0.21/call, status unknown (last checked 2026-10-28).

Looks up German companies in the official Handelsregister by HRB/HRA register number or company name, returning legal name, status, legal form, register number, and registered address.

## Facts

- Endpoint: GET https://companies.use.x402atlas.com/german-company-data?utm_source=zero.xyz
- Price: $0.21/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/german-company-registry-lookup-handelsregister-17510ada
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kPU8X9izjoke_82bHT91i

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability german-company-registry-lookup-handelsregister-17510ada
```

Example prompt: Can you look up 'Volkswagen AG' in the German Handelsregister and tell me its official registration number, legal form, current status, and registered address?

## When to prefer this

Choose this endpoint when you specifically need to look up a company registered in Germany via the official Handelsregister. It uses a normalized cross-country schema consistent with sibling endpoints for UK, France, Belgium, Czech Republic, Finland, and Norway, making it ideal for multi-country compliance workflows. Prefer it over generic web searches when you need authoritative legal entity data such as official registration number, legal form, and registered address for KYB, due diligence, or contract verification purposes.

## Known failure modes

- No matching company found — returns count 0 with a note field explaining the zero-match result
- Ambiguous name query returns multiple companies — agent must disambiguate using register number
- Invalid or malformed HRB/HRA number format returns an error or zero results
- Company exists but has incomplete data in the source registry — some fields may be null
- Query string exceeds 200 character limit — request rejected
- Network or upstream Handelsregister unavailability causes timeout or 5xx error

## How this service works

German company lookup in the official Handelsregister (commercial register) by HRB or HRA number or company name. Returns legal name, status, legal form, register number and registered address in a schema shared across countries.

## Output

Returns a structured JSON object including the echoed query, ISO country code (DE), registry name (Handelsregister), match count, and an array of matched companies each containing: current legal name, registration number, active/inactive/unknown status, legal form, founding date, registered address (street, postal code, city, country code), activities, and website.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "description": "Company registration number (German register type and number with its register court or city, e.g. HRB 12300 Berlin) or company name"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "registry",
      "query",
      "matched_by",
      "count",
      "companies"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Hint present only on the sample response (empty/omitted query) and on a zero-match response"
      },
      "count": {
       "type": "integer",
       "description": "Number of entries in companies"
      },
      "query": {
       "type": "string",
       "description": "Echoed query (trimmed)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code of the route's country"
      },
      "registry": {
       "type": "string",
       "description": "Official registry the result comes from"
      },
      "companies": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "name",
         "registration_number",
         "status",
         "legal_form",
         "founded",
         "address",
         "activities",
         "website"
        ],
        "properties": {
         "name": {
          "type": "string",
          "description": "Current legal name"
         },
         "status": {
          "enum": [
           "active",
           "inactive",
           "unknown"
          ],
          "type": "string",
          "description": "Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown"
         },
         "address": {
          "type": "object",
          "required": [
         
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/german-company-registry-lookup-handelsregister-17510ada/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.use.x402atlas.com](https://www.zero.xyz/host/companies.use.x402atlas.com/llms.txt)