DownloadDocument API

Downloads the latest version of a document and returns its content as a raw byte array. This is a single-call download suitable for small to medium-sized files. For large files, use the chunked download workflow (GetDownloadHandler → DownloadFileChunk → DeleteDownloadHandler) instead.

Endpoint

/srv.asmx/DownloadDocument

Methods

• GET /srv.asmx/DownloadDocument?authenticationTicket=...&Path=...
• POST /srv.asmx/DownloadDocument (form data)
• SOAP Action: http://tempuri.org/DownloadDocument

Parameters

Response

Success Response

The response body contains the raw binary content of the document's latest version.

• REST (GET/POST): Returns raw bytes (application/octet-stream).
• SOAP: Returns a base64-encoded byte array within the SOAP response envelope.

Error Response

On any error (authentication failure, document not found, offline document, or download failure), an empty byte array is returned. There is no XML error message. The caller must check whether the returned byte array is empty to detect failure.

Required Permissions

Any authenticated user with read access to the document may call this API.

Example

GET Request

GET /srv.asmx/DownloadDocument
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &Path=/MyLibrary/Reports/Report.pdf
HTTP/1.1

POST Request

POST /srv.asmx/DownloadDocument HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&Path=/MyLibrary/Reports/Report.pdf

SOAP Request

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:DownloadDocument>
      <tns:authenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:authenticationTicket>
      <tns:Path>/MyLibrary/Reports/Report.pdf</tns:Path>
    </tns:DownloadDocument>
  </soap:Body>
</soap:Envelope>

SOAP Response (success)

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DownloadDocumentResponse xmlns="http://tempuri.org/">
      <DownloadDocumentResult>JVBERi0xLjQK...</DownloadDocumentResult>
    </DownloadDocumentResponse>
  </soap:Body>
</soap:Envelope>

Notes

• This API always downloads the latest version of the document. To download a specific version use DownloadDocumentVersion.
• If the document is in Offline state, an empty byte array is returned.
• On any error (invalid ticket, path not found, permission denied, download failure), the response is an empty byte array with no accompanying error message. Use DocumentExists to verify the document is accessible before downloading if you need explicit error details.
• For large files, prefer the chunked download workflow to avoid memory and timeout issues: GetDownloadHandler → DownloadFileChunk → DeleteDownloadHandler.
• The downloaded bytes represent the file exactly as stored in the warehouse — no conversion or transformation is applied.

Related APIs

• DownloadDocumentVersion - Download a specific version of a document
• GetDownloadHandler - Prepare a document for chunked download (recommended for large files)
• DownloadFileChunk - Download a chunk of a file using a handler
• DocumentExists - Check whether a document exists and retrieve its CRC32 checksums
• GetDocument - Get document properties without downloading content

Error Codes

For detailed documentation visit: https://support.inforouter.com/api-docs/DownloadDocument