# agosint German Commercial Register (Handelsregister) Lookup

> agosint German Commercial Register (Handelsregister) Lookup is a paid API for AI agents from agosint.shveik.dev, paid per call via x402, $0.056/call, status unknown (last checked 2026-10-13).

Retrieves full German Handelsregister records including register court/number, legal form, status, seat, capital, representation rules, officers, and history for a named German company.

## Facts

- Endpoint: POST https://agosint.shveik.dev/x402/company-de?utm_source=zero.xyz
- Price: $0.056/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agosint-german-commercial-register-handelsregister-lookup-178be7eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2x-Mzbf35At5n6DxcMUaY

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 agosint-german-commercial-register-handelsregister-lookup-178be7eb -d '<json body>'
```

Example prompt: Look up the Handelsregister record for Volkswagen AG in Wolfsburg — I need the register court and number, legal form, current status, share capital, and list of officers, returning up to 1 result with an exact name match.

## When to prefer this

Use this endpoint specifically when the target company is German and you need authoritative Handelsregister data (legal form, officers, capital, representation rules, history). Prefer this over generic company enrichment endpoints when German-specific register fields (HRA/HRB number, Amtsgericht court, Prokura rules) are required. For non-German companies use the sibling business registry or KYB endpoints instead. Be aware of the ~1 minute latency; do not use in real-time interactive flows.

## Known failure modes

- Company not found — returns empty results if no match exists in the Handelsregister
- Ambiguous name with many matches — results capped at the requested limit (max 5); caller may need to narrow search with city, postal code, or register details
- Timeout or slow response — the endpoint is known to take ~60 seconds; callers must not set short timeouts
- Invalid register_type enum — request rejected with validation error
- Rate limiting or payment failure — x402 payment not processed, request blocked

## How this service works

German commercial register (Handelsregister) record: register court and number, legal form, status, seat, capital, representation rules, officers and history. Slower (about a minute). Use when: the company is German.

## Output

Returns structured Handelsregister record(s) for matching German companies, including: register court and number, legal form (e.g. GmbH, AG), current status (active/deleted), registered seat, share capital, representation rules, named officers with roles, and historical changes. Response time is approximately one minute.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "maxLength": 80
  },
  "name": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2
  },
  "limit": {
   "type": "integer",
   "maximum": 5,
   "minimum": 1
  },
  "match": {
   "enum": [
    "all",
    "any",
    "exact"
   ],
   "type": "string"
  },
  "legal_form": {
   "type": "string",
   "maxLength": 80
  },
  "postal_code": {
   "type": "string",
   "maxLength": 10
  },
  "register_type": {
   "enum": [
    "HRA",
    "HRB",
    "GnR",
    "PR",
    "VR",
    "GsR"
   ],
   "type": "string"
  },
  "register_court": {
   "type": "string",
   "maxLength": 80
  },
  "include_deleted": {
   "type": "boolean"
  },
  "register_number": {
   "type": "string",
   "maxLength": 40
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agosint-german-commercial-register-handelsregister-lookup-178be7eb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agosint.shveik.dev](https://www.zero.xyz/host/agosint.shveik.dev/llms.txt)