Germany

Germany eKYB validates the legitimacy of German businesses by checking their tax ID, business name, address, UBOs, and directors against German government sources of truth.

Source

Country	Source	Description
Germany	German government sources of truth	Verifies submitted business details against records maintained in German registries.

Direct API approach

For general integration notes and shared response semantics, see the eKYB API Reference.

Request parameters

Parameter	Required	Description
`plugins`	Mandatory	Array. Must be `["ekyb"]`.
`businessName`	Mandatory	String. Name of the business.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `DE`.
`taxId`	Mandatory	String. Accepts VAT (`DE + 9 digits`), SafeNo (`DE + 8 digits`), or Reg No (HRB or HRA). See Tax ID formats for details.
`street`	Optional	String. Street name of the business.
`houseNo`	Optional	String. Building or house number.
`addressLine2`	Optional	String. Second line of the business address.
`city`	Optional	String. City in the business address.
`state`	Optional	String. State in the business address.
`postalCode`	Optional	String. 5-digit German postal code.
`uboNames`	Optional	Array. Full legal names of Unique Beneficial Owners to check against records associated with the business.
`directors`	Optional	Array. Full legal names of directors to check against records associated with the business.

Tax ID formats

Tax ID Type	Format
VAT	`DE` + 9 digits
SafeNo	`DE` + 8 digits
Reg No (HRB or HRA)	`HRB` + 3-6 digits, `HRB` + 6 digits + letter, `HRA` + 4-6 digits, or 4-6 digits (handled as `HRB` + 4-6 digits)

Sample request

{
  "plugins": ["ekyb"],
  "businessName": "BERLIN TECH SOLUTIONS GMBH",
  "street": "Kurfürstendamm",
  "houseNo": "182",
  "addressLine2": "Charlottenburg-Wilmersdorf",
  "city": "Berlin",
  "state": "Berlin",
  "postalCode": "10707",
  "country": "DE",
  "taxId": "123456789",
  "uboNames": ["John Schmidt", "Emily Bauer"],
  "directors": ["David Meyer", "Anna Weber"]
}

Sample response

{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified", "reasonCodes": ["REGNO"] },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "General Partnership" }
    },
    { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "John Schmidt" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Emily Bauer" },
    { "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "David Meyer" },
    { "key": "directors_name_match", "sub_label": "Unverified", "directorsName_input": "Anna Weber" }
  ]
}

Response fields

Key	Status	Description
`name`	`Verified`, `Approximate Match`, `Unverified`	Submitted business name against the business name associated with the tax ID.
`tin`	`Verified`, `Unverified`	Submitted tax ID against the government database.
`address_verification`	`Verified`, `Approximate Match`, `Unverified`	Submitted address against the address associated with the tax ID.
`cityMatch`	`Verified`, `Approximate Match`, `Unverified`	Submitted city against the city associated with the tax ID.
`postalCodeMatch`	`Verified`, `Unverified`	Submitted postal code against the postal code associated with the tax ID.
`registrationStatus`	`Active`, `Inactive`, `Unknown`	Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation.
`entityType`	Legal entity type of the business	The legal entity type of the company, if available. If not available, displays `Unknown`.
`ubo_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry.
`directors_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted director against directors associated with the business. Distinguished by the `directorsName_input` field.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.