# Netzhandwerker Business Resolve

> Netzhandwerker Business Resolve is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Resolves and enriches German business entity data by cross-referencing VAT IDs, VIES, and Impressum sources to return structured company information.

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/business/resolve
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-business-resolve-be4046cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lmxwOWbYcfcWzRfMTVqOs

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 netzhandwerker-business-resolve-be4046cc -d '<json body>'
```

Example prompt: Can you resolve the business details for 'Netzhandwerker' with VAT ID DE355216638 and domain netzhandwerker.de — I need their legal name, registered address, managing directors, and registration number?

## When to prefer this

Choose this endpoint when you need to resolve or enrich German business entity data using publicly available open sources such as VIES, VAT registries, and website Impressum pages. It is ideal for pre-contract due diligence, invoice verification, CRM enrichment, or any workflow requiring structured legal entity data for German companies. It is not a substitute for an official Handelsregisterauszug or a credit rating, but excels at fast, automated resolution combining multiple open signals into a single structured response with confidence scoring and provenance.

## Known failure modes

- VAT ID not found in VIES — returns source ok:false for vies with no resolved data
- Domain has no accessible Impressum page — impressum source fails, reducing confidence
- Conflicting data across sources — conflicts array populated, confidence score lowered
- Malformed VAT ID format — vat_format source returns ok:false
- Insufficient input provided — if no name, domain, VAT ID, or registration number given, resolution may return empty or low-confidence result
- Network timeout reaching external sources — partial results with failed source entries

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a structured JSON object containing the resolved company's legal name, email, phone, VAT ID, formatted address, country, legal form, register court, managing directors, and registration numbers. Also includes a confidence score (0–1), a list of sources consulted (e.g. vat_format, VIES, Impressum), any detected conflicts between sources, and field-level provenance showing which source contributed each value and with what confidence. A disclaimer note clarifies this is a synthesis of open sources, not an official registry excerpt.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string"
  },
  "domain": {
   "type": "string"
  },
  "vat_id": {
   "type": "string",
   "description": "USt-IdNr. mit Laenderpraefix"
  },
  "address": {
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "include_raw": {
   "type": "boolean",
   "default": false
  },
  "registration_number": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Zusammenfuehrung offener Quellen. Kein Handelsregisterauszug, keine Bonitaetsaussage.",
  "input": {
   "name": "Netzhandwerker",
   "domain": "netzhandwerker.de",
   "vat_id": "DE355216638",
   "address": null,
   "country": null,
   "registration_number": null
  },
  "sources": [
   {
    "ok": true,
    "source": "vat_format"
   },
   {
    "ok": true,
    "source": "vies"
   },
   {
    "ok": true,
    "url": "https://netzhandwerker.de/impressum",
    "source": "impressum"
   }
  ],
  "resolved": {
   "name": "Netzhandwerker GmbH",
   "email": "info@netzhandwerker.de",
   "phone": "+49 2562 1234567",
   "vat_id": "DE355216638",
   "address": "Beispielweg 3, 48599 Gronau",
   "country": "DE",
   "base_name": "Netzhandwerker",
   "legal_form": "GmbH",
   "register_court": "Amtsgericht Coesfeld",
   "managing_directors": [
    "Daniel Beispiel"
   ],
   "registration_numbers": [
    "HRB 12345"
   ]
  },
  "conflicts": [],
  "confidence": 1,
  "field_provenance": {
   "name": [
    {
     "value": "Netzhandwerker",
     "source": "eingabe",
     "confidence": 0.5
    },
    {
     "value": "Netzhandwerker GmbH",
     "source": "vies",
     "confidence": 0.95
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-business-resolve-be4046cc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)