Signatures
Document Download
Downloads a previously stored document by its storage id and returns the raw file as an octet-stream. The caller must own the file.
AuthorizationBearer <token>
JWT token to authenticate the request.
In: header
X-Api-Key<token>
API key, sent as a request header.
In: header
Path Parameters
documentId*string
Storage id (GUID) of the document to download, as returned by an upload or generation response.
Format
uuidResponse Body
application/octet-stream
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/signatures/document/497f6eca-6276-4993-bfeb-53cbbbba6f08/download"Empty
{ "error": { "statusCode": 401, "message": "The request could not be authenticated.", "innerErrors": [ { "code": "UNAUTHORIZED", "message": "The request could not be authenticated.", "userMessage": "Your session has expired or is invalid. Please sign in again." } ] }, "origin": "GET https://api.doctavian.com/v1/signatures/document/{documentId}/download", "dateTime": "2026-07-14T09:32:15.000Z", "operationId": "3a4b5c6d7e8f90112233445566778899", "userId": "4abc2cf3-2a8a-42bb-aa4b-ca959bf0e41b"}{ "error": { "statusCode": 403, "message": "The requested file does not belong to the authenticated user.", "innerErrors": [ { "code": "FILE_ACCESS_DENIED", "message": "The requested file does not belong to the authenticated user.", "userMessage": "You don't have access to this file." } ] }, "origin": "GET https://api.doctavian.com/v1/signatures/document/{documentId}/download", "dateTime": "2026-07-14T09:32:15.000Z", "operationId": "3a4b5c6d7e8f90112233445566778899", "userId": "c6363f99-c55b-4ef9-8ad7-31523e21d6ee"}{ "error": { "statusCode": 404, "message": "No file was found for the supplied id.", "innerErrors": [ { "code": "NOT_FOUND_BY_ID", "message": "No file was found for the supplied id.", "userMessage": "We couldn't find that file. Check the id and try again." } ] }, "origin": "GET https://api.doctavian.com/v1/signatures/document/{documentId}/download", "dateTime": "2026-07-14T09:32:15.000Z", "operationId": "3a4b5c6d7e8f90112233445566778899", "userId": "ed376297-72e5-4641-9d8a-17f0c9a81e2f"}{ "error": { "statusCode": 500, "message": "Failed to read the requested file from storage.", "innerErrors": [ { "code": "FILE_DOWNLOAD_FAILED", "message": "Failed to read the requested file from storage.", "userMessage": "Something went wrong while downloading. Please try again or contact support." } ] }, "origin": "GET https://api.doctavian.com/v1/signatures/document/{documentId}/download", "dateTime": "2026-07-14T09:32:15.000Z", "operationId": "3a4b5c6d7e8f90112233445566778899", "userId": "a6d55d8b-900c-48d1-a677-c42ef54dd42c"}