Get Trade Registration
Fetch the full data and the documents of a trade registration case
GET https://api.beglaubigt.de/v1/trade-registration/:id
Retrieve a trade registration created via POST /v1/trade-registration. Access is granted to either side of the case: the provider company that created it and the client company it was created for.
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Path Parameters
idstringrequiredThe trade_registration_id returned by the POST endpoint, in UUID format.
Example: 450506c1-d1a7-46e2-aca6-41a816805595
Response
resultstringIndicates the outcome of the request.
Possible values: success or error
messagestringHuman-readable message describing the result.
Example: Trade registration fetched successfully.
trade_registration_idstringThe unique identifier of the trade registration in UUID format.
Example: 450506c1-d1a7-46e2-aca6-41a816805595
company_idstringThe unique identifier of the client company the case belongs to, in UUID format.
Example: 9b2e4c7a-1d3f-4a8b-9c6e-2f5a7b8c1d0e
statusstringCurrent status of the case. These are the states to act on, and they mirror the registration.*
webhook events. Further internal states can appear while the trade office is processing the case.
Possible values: initiated, form-rendered, submitted, completed or blocked
packagestringThe service package the case was created with.
Possible values: self or assisted
reasonstringWhy the trade was registered.
Possible values: new-foundation, takeover, reopening-after-relocation,
legal-form-change, partner-entry or transformation-law
operational_activity_start_datestringThe date the business begins operating, normalized to YYYY-MM-DD.
Example: 2030-12-01
establishment_typestringThe kind of establishment that was registered.
Possible values: main-office, branch-office, dependent-branch or travel-industry
acquisition_typestringWhether the trade is the owner's main or secondary occupation.
Possible values: main-occupation or secondary-occupation
namestringThe business name, taken from the client company.
Example: Musterbau GmbH
legal_formstringThe legal form, taken from the client company.
Example: gmbh
registration_numberstringThe number the business is entered under in a public register, present when it is registered.
Example: HRB 123456 B
business_typearrayThe categories the activity falls into.
Possible values: industry, trade, craft or other
purposestringDescription of the registered activity, as it appears on the GewA 1.
Example: Innenausbau und Trockenbauarbeiten
registered_officeobjectAddress of the establishment. Always a German address, since only a fixed German establishment can file a GewA 1 (§ 14 GewO).
streetstringStreet and house number.
Example: Friedrichstraße 176
street_second_linestringA second address line (c/o, entrance, floor, ...).
Example: Aufgang C
zipstringGerman 5-digit postal code.
Example: 10117
citystringCity.
Example: Berlin
countrystringCountry as an ISO 3166-1 alpha-2 code, always DE.
Example: DE
phonestringPhone number of the business.
Example: +4930123456
emailstringEmail address of the business.
Example: kontakt@musterbau.de
industrial_licenseobjectDetails of the permit the activity requires, present when the activity needs one.
issue_datestringDate the permit was issued.
Example: 2024-01-15
issuing_authoritystringAuthority that issued the permit.
Example: Bezirksamt Mitte von Berlin
zipstringGerman 5-digit postal code of the issuing authority.
Example: 10117
locationstringCity of the issuing authority.
Example: Berlin
has_public_sector_participationbooleanWhether a public-sector body holds a stake in the business.
Possible values: true or false
employeesobjectThe employee counts, present when the business has employees.
full_timestringNumber of full-time employees, as a bracket.
Possible values: 0, 1, 2, 3, 4, 5, 6-10, 11-20, 21-50 or 50+
part_timestringNumber of part-time employees, as a bracket.
Possible values: 0, 1, 2, 3, 4, 5, 6-10, 11-20, 21-50 or 50+
ownersarrayEveryone registering the trade, in the order they were created. Each owner carries their own permit, address and signatures.
first_namestringFirst name.
Example: Anna
last_namestringLast name.
Example: Schmidt
birth_namestringBirth name, present when it differs from the last name.
Example: Weber
dobstringDate of birth.
Example: 1986-03-12
place_of_birthstringCity of birth.
Example: Leipzig
country_of_birthstringCountry of birth as an ISO 3166-1 alpha-2 code.
Example: DE
nationalitystringNationality as an ISO 3166-1 alpha-2 code.
Example: DE
genderstringGender, as asked on the GewA 1.
Possible values: male, female, diverse or no-information
phonestringPhone number of the owner.
Example: +4915100000001
emailstringEmail address of the owner.
Example: anna.schmidt@beispiel.de
identity_verified_atstringTimestamp of the completed identity verification (KYC), as an ISO 8601 string. Present
once the owner has verified their identity.
Example: 2025-02-03T09:12:45.000Z
residence_permitobjectDetails of this owner's residence permit, present when they hold one.
issue_datestringDate the permit was issued.
Example: 2023-02-01
issuing_authoritystringAuthority that issued the permit.
Example: Ausländerbehörde Berlin
has_employment_restrictionsbooleanWhether the residence permit restricts self-employment.
Possible values: true or false
addressobjectThis owner's residential address, present when they live elsewhere than the establishment.
streetstringStreet and house number.
Example: Kastanienallee 12
street_second_linestringA second address line.
Example: Hinterhaus
zipstringPostal code.
Example: 10435
citystringCity.
Example: Berlin
statestringState or region.
Example: Berlin
countrystringCountry as an ISO 3166-1 alpha-2 code.
Example: DE
trade_officeobjectThe trade office (Gewerbeamt) the registration is filed with, present once it has been determined.
namestringName of the trade office.
Example: Gewerbeamt Berlin-Mitte
addressstringPostal address of the trade office, as a single line.
Example: Karl-Marx-Allee 31, 10178 Berlin
emailstringEmail address of the trade office.
Example: gewerbeamt@ba-mitte.berlin.de
phonestringPhone number of the trade office.
Example: +4930901823456
websitestringWebsite of the trade office.
Example: https://www.berlin.de/ba-mitte
pricenumberPrice of the service in euros.
Example: 89
city_feenumberThe trade office's registration fee in euros, present once it is known.
Example: 26.5
is_paidbooleanWhether the case has been paid.
Possible values: true or false
documentsarrayThe documents of the case. The filled GewA 1 form (trade-licence-application) exists from
creation; the trade licence (trade-licence) is added once the trade office has issued it.
idstringThe unique identifier of the document in UUID format.
Example: baa38d14-c224-4894-823a-87536c5e45d4
typestringThe document type.
Possible values: trade-licence-application or trade-licence
namestringDisplay name of the document.
Example: GewA 1 - Gewerbe-Anmeldung
download_urlstringA signed URL to download the document as a PDF. Valid for 24 hours after the request.
Example: https://app.beglaubigt.de/download?bucket=company-documents&id=baa38d14-c224-4894-823a-87536c5e45d4&token=a1H...To5
source_productstringSet when the trade registration was spawned by another Beglaubigt product.
Possible values: gbr or null
client_referencestringThe custom reference string provided when creating the registration through the POST request.
Example: REF-2025-001
client_preferred_languagestringThe language used when communicating with the client.
Possible values: en, fr, de, it or es
created_atstringTimestamp when the trade registration was created, as an ISO 8601 string.
Example: 2025-02-01T07:19:30.443Z
--request GET 'https://api.beglaubigt.de/v1/trade-registration/450506c1-d1a7-46e2-aca6-41a816805595' \
--header 'Authorization: Bearer <token>'{
"response": {
"result": "success",
"message": "Trade registration fetched successfully.",
"trade_registration_id": "450506c1-d1a7-46e2-aca6-41a816805595",
"company_id": "9b2e4c7a-1d3f-4a8b-9c6e-2f5a7b8c1d0e",
"status": "submitted",
"package": "assisted",
"reason": "new-foundation",
"operational_activity_start_date": "2030-12-01",
"establishment_type": "main-office",
"acquisition_type": "main-occupation",
"name": "Musterbau GmbH",
"legal_form": "gmbh",
"registration_number": "HRB 123456 B",
"business_type": ["craft", "trade"],
"purpose": "Innenausbau und Trockenbauarbeiten",
"registered_office": {
"street": "Friedrichstraße 176",
"street_second_line": "Aufgang C",
"zip": "10117",
"city": "Berlin",
"country": "DE"
},
"phone": "+4930123456",
"email": "kontakt@musterbau.de",
"industrial_license": {
"issue_date": "2024-01-15",
"issuing_authority": "Bezirksamt Mitte von Berlin",
"zip": "10117",
"location": "Berlin"
},
"has_public_sector_participation": false,
"employees": {
"full_time": "6-10",
"part_time": "2"
},
"owners": [
{
"first_name": "Anna",
"last_name": "Schmidt",
"birth_name": "Weber",
"dob": "1986-03-12",
"place_of_birth": "Leipzig",
"country_of_birth": "DE",
"nationality": "DE",
"gender": "female",
"phone": "+4915100000001",
"email": "anna.schmidt@beispiel.de",
"identity_verified_at": "2025-02-03T09:12:45.000Z",
"address": {
"street": "Kastanienallee 12",
"zip": "10435",
"city": "Berlin",
"state": "Berlin",
"country": "DE"
}
},
{
"first_name": "Jonas",
"last_name": "Meier",
"dob": "1984-02-11",
"place_of_birth": "Bremen",
"country_of_birth": "DE",
"nationality": "DE",
"gender": "male",
"phone": "+4915100000004",
"email": "jonas.meier@beispiel.de"
}
],
"trade_office": {
"name": "Gewerbeamt Berlin-Mitte",
"address": "Karl-Marx-Allee 31, 10178 Berlin",
"email": "gewerbeamt@ba-mitte.berlin.de",
"phone": "+4930901823456",
"website": "https://www.berlin.de/ba-mitte"
},
"price": 89,
"city_fee": 26.5,
"is_paid": true,
"documents": [
{
"id": "baa38d14-c224-4894-823a-87536c5e45d4",
"type": "trade-licence-application",
"name": "GewA 1 - Gewerbe-Anmeldung",
"download_url": "https://app.beglaubigt.de/download?bucket=company-documents&id=baa38d14-c224-4894-823a-87536c5e45d4&token=a1H...To5"
}
],
"source_product": null,
"client_reference": "REF-2025-001",
"client_preferred_language": "de",
"created_at": "2025-02-01T07:19:30.443Z"
}
}