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.
company_idstringThe unique identifier of the client company the case belongs to, in UUID format.
Example: 9b2e4c7a-1d3f-4a8b-9c6e-2f5a7b8c1d0e
statusstringCurrent status, the same set as the POST response: validated while an assisted registration waits for
the lawyer, submitted once filed with ELSTER, and blocked while our team checks a filing that failed
unexpectedly.
Possible values: validated, submitted or blocked
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.
documentsobjectFresh download links for the filing's PDFs, present once the registration was filed with ELSTER. Each link is valid for 24 hours after the request.
questionnaire_urlstringThe tax registration questionnaire as filed.
confirmation_urlstringELSTER's confirmation of the filing, with the transfer ticket.
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 retrieved successfully.",
"tax_registration_id": "450506c1-d1a7-46e2-aca6-41a816805595",
"company_id": "9b2e4c7a-1d3f-4a8b-9c6e-2f5a7b8c1d0e",
"status": "submitted",
"transfer_ticket": "et1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
"download_url": "https://app.beglaubigt.de/download?bucket=tax-questionnaire-submissions-xml&id=450506c1-d1a7-46e2-aca6-41a816805595&token=a1H...To5",
"documents": {
"questionnaire_url": "https://app.beglaubigt.de/download?bucket=company-documents&id=3f1c2b9e-7d4a-4c1e-9b2f-5a8d6e7f9c0b&token=c3K...Vq7",
"confirmation_url": "https://app.beglaubigt.de/download?bucket=company-documents&id=8a2d4e6f-1b3c-4d5e-8f9a-0b1c2d3e4f5a&token=d4L...Wr8"
},
"client_reference": "REF-2025-001",
"created_at": "2025-02-01T07:19:30.443Z"
}
}