Skip to content

Download the result

Base URL https://api.accessful.de/api/v1/upload-service. The direct download and link creation require the X-API-Key header — see Authentication.

GET /download/{caseId}

Returns the converted PDF/UA as binary application/pdf with Content-Disposition: attachment. The response also carries a pdf-version header with the iteration number. An optional ?suffix= query string is appended to the downloaded file name.

404 is returned while no result exists yet — poll job status until completed first.

POST /download/{caseId}/link
X-API-Key: <your-key>

After completed, the owner receives 200 with downloadUrl, expiresAt (ISO 8601), filename and mimeType: application/pdf. The signed HTTPS link is valid for five minutes and grants access only to the selected result version, without an API key in the browser. Call the endpoint again to renew an expired link. Keep the URL out of logs and public messages.

Minting returns 403 for another owner’s case, 404 for an unknown case, 409 when the result is not complete, and 503 when signed links are not enabled. The link targets GET /download/signed?token=…; expired or tampered tokens return 403 and deleted results 404. Successful downloads include Cache-Control: no-store and Referrer-Policy: no-referrer.