# 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-14).

Looks up German companies in the official Handelsregister by name, register number, court, or legal form and returns structured legal entity data including status, officers, and address.

## Facts

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

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-4d94f949 -d '<json body>'
```

Example prompt: Look up the German company 'Müller Maschinenbau GmbH' in the Handelsregister — match exact name, limit to 3 results, and include deleted entities too so I can see if it's still active.

## When to prefer this

Choose this endpoint when you specifically need to query the German Handelsregister (Handelregister HRA/HRB/GnR/PR/VR/GsR) for legal entity data on German companies. It is ideal for KYB workflows, vendor onboarding, and legal due diligence where you need official German register data — including officer lists, legal form, and status — signed and delivered per-call without requiring an account. Prefer this over generic company lookup endpoints when the target entity is definitively German and you need register-court-level precision.

## Known failure modes

- No matching company found for the given search criteria (empty results)
- Ambiguous name match when using 'any' or 'all' match mode returns multiple unrelated entities
- Register court or register type enum value not accepted (validation error)
- Company name too short (minLength 2) or too long (maxLength 120) triggers schema validation failure
- Limit exceeds maximum of 5, causing request rejection
- Payment failure or insufficient USDC balance prevents call execution
- Handelsregister source temporarily unavailable, causing retrieval error

## How this service works

Company and domain due diligence for AI agents: official registers, sanctions lists and domain records, signed. Pay per call in stablecoins, no account.

## Output

Returns a structured JSON object with the company's official name, legal form, registration status (active/deleted), registered address, officers list, activity codes, the source register URL, raw register fields, retrieval timestamp, and a payment receipt confirming the signed, per-call transaction.

## 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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "Amtsgeri…",
  "name": "Beispiel…",
  "note": "Public r…",
  "schema": "agosint.…",
  "source": "Handelsr…",
  "status": "active",
  "address": {},
  "country": "DE",
  "receipt": {},
  "officers": [],
  "legal_form": "Gesellsc…",
  "raw_fields": {},
  "source_url": "https://…",
  "retrieved_at": "2026-10-…",
  "activity_codes": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agosint-german-commercial-register-handelsregister-lookup-4d94f949/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)