{"uid":"cap_kPU8X9izjoke_82bHT91i","slug":"german-company-registry-lookup-handelsregister-17510ada","name":"German Company Registry Lookup (Handelsregister)","description":"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.","url":"https://companies.use.x402atlas.com/german-company-data?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":["street","postal_code","city","country_code"],"properties":{"city":{"type":["string","null"],"description":"City or post town"},"street":{"type":["string","null"],"description":"Street and house number"},"postal_code":{"type":["string","null"],"description":"Postal code"},"country_code":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 country code of the address"}},"description":"Registered (head-office) address; each part is null when the registry does not supply it"},"founded":{"type":["string","null"],"format":"date","description":"Founding / registration date (YYYY-MM-DD)"},"website":{"type":["string","null"],"description":"Company website as registered; may lack a URL scheme"},"activities":{"type":"array","items":{"type":"object","required":["code","description"],"properties":{"code":{"type":"string","description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)"},"description":{"type":["string","null"],"description":"Activity description; null when the registry supplies only the code"}}},"maxItems":5,"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published"},"legal_form":{"type":["string","null"],"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name"},"registration_number":{"type":"string","description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO, SK ICO, DE register type and number)"}}},"maxItems":5,"description":"Matching companies; empty when nothing matched (still HTTP 200)"},"matched_by":{"enum":["number","name"],"type":"string","description":"number: the query was read as a registration number (exact lookup, 0 or 1 company; a German number without its court can match up to 5); name: company-name search (up to 5 companies)"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.21","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.21/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.21","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.21","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uZMjzCfnS4RHT_jJswat1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.21","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"Can you look up 'Volkswagen AG' in the German Handelsregister and tell me its official registration number, legal form, current status, and registered address?","exampleUseCases":[{"title":"Vendor due diligence before contract signing","prompt":"Before we sign this supplier contract, can you verify that 'Bosch GmbH' is an active registered company in Germany? I need its HRB number, legal form, and registered address from the Handelsregister."},{"title":"Checking a company by HRB number","prompt":"I have a German company registration number HRB 12300 Berlin — can you pull the official Handelsregister record and tell me the company's legal name, status, and address?"},{"title":"KYB screening for a new business partner","prompt":"We're onboarding a new German partner called 'Siemens AG' — can you confirm they're active in the Handelsregister and fetch their official legal details including registration number and registered office?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T15:31:05.798Z","isFirstParty":false,"canonicalSlug":"german-company-registry-lookup-handelsregister-17510ada"}