Download Document

Service for downloading a stored document using the pre-signed download URL.

The download URL is valid for 5 years from its generation. The response is a redirect to the file's actual location.

When used in a browser, the browser will follow the redirect transparently for the user.

The download URL contains a JWT Token valid for 5 years. If the download URL is lost, it will not be possible to recover the file.

Endpoint

GET /custody/download/{downloadToken}

Route parameters

Parameter	Type	Required	Description
downloadToken	string	Yes	Download Token of the pre-signed URL (JWT valid for 5 years).

Responses

302 Found

Redirects to the file's direct download URL.

Response headers

Header	Type	Description
Location	string	Direct file download URL.
Content-Type	string	File content type.

401 Unauthorized

{
  "message": "Unauthorized"
}

403 Forbidden

{
  "Message": "User is not authorized to access this resource with an explicit deny"
}

404 Not Found

{
  "status": 404,
  "title": "Not Found",
  "detail": "Document doesn't exist.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
  "errors": []
}

502 Bad Gateway

{
  "status": 502,
  "title": "Bad Gateway",
  "detail": "Server got an invalid response.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}

504 Gateway Timeout

{
  "message": "Endpoint request timed out"
}