Get Tax Registration
Poll the status and download the generated XML of a tax registration
GET https://api.beglaubigt.de/v1/tax-registration/:id
Retrieve a tax registration created via POST /v1/tax-registration, regardless of legal form. The response is the same shape for every family.
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 tax_registration_id returned by the POST endpoint, in UUID format.
Example: 450506c1-d1a7-46e2-aca6-41a816805595
Response
resultstringIndicates the outcome of the API request.
Possible values: success or error
messagestringHuman-readable message describing the result.
tax_registration_idstringThe unique identifier of the tax registration in UUID format.
statusstringCurrent status, taken from the tax registration's XML draft. draft until an XML has been generated.
Possible values: draft, validated, submitted, accepted, rejected or error
transfer_ticketstringELSTER transfer ticket, present once the registration has been submitted.
download_urlstringA signed URL to download the generated ELSTER XML, present once an XML draft exists. Valid for 24 hours after the request.
client_referencestringThe custom reference string provided when creating the registration through the POST request.
Example: REF-2025-001
created_atstringTimestamp when the tax registration was created, as an ISO 8601 string.
--request GET 'https://api.beglaubigt.de/v1/tax-registration/450506c1-d1a7-46e2-aca6-41a816805595' \
--header 'Authorization: Bearer <token>'{
"response": {
"result": "success",
"message": "Tax registration XML document retrieved successfully.",
"tax_registration_id": "450506c1-d1a7-46e2-aca6-41a816805595",
"status": "validated",
"download_url": "https://app.beglaubigt.de/download?bucket=tax-questionnaire-submissions-xml&id=450506c1-d1a7-46e2-aca6-41a816805595&token=a1H...To5",
"client_reference": "REF-2025-001",
"created_at": "2025-02-01T07:19:30.443Z"
}
}