Get Company

Fetch German Handelsregister company data by canonical company ID or exact register tuple.

[!NOTE] See the API Guide for the shared request lifecycle (sync, async polling, async webhook), error envelope, rate limits, custom_vars, and deduplication. This endpoint uses the German registry pilot feature gate.

Try it

Pricing

Endpoint

Input Parameters

Provide either company_id or all three tuple fields: register_type, court_code, and register_number.

Examples

Output Fields

Cache Freshness

Mirror rows refreshed within 30 days are served without a Handelsregister request. Stale or missing rows are refreshed from SI XML via direct Laravel HTTP with JSF ViewState and cookies.

Error Responses

Validation Error (422)

{
    "message": "The company_id field is required when a register tuple is not provided.",
    "errors": {
        "company_id": ["The company_id field is required when a register tuple is not provided."]
    }
}

Feature Disabled (403)

{
    "message": "German registry enrichments are not enabled for this organization."
}

Typical Response Times

Cache hit: under 1 second
Live Handelsregister fetch: 5-30 seconds