Skip to main content
GET
/
v1
/
transfers
/
{id}
/
download
Download Transfer
curl --request GET \
  --url https://agentdrop-production.up.railway.app/v1/transfers/{id}/download \
  --header 'Authorization: <authorization>'

​
Download Transfer

Download the files from a transfer. Each call decrements the remaining download count.
Downloads are counted. Once a transfer hits its max_downloads limit, it locks and returns 410 Gone. Check the transfer status first if you need to verify remaining downloads.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The transfer ID. Example: txfr_abc123

​
Response

Returns the file content as a binary stream. The Content-Type header reflects the original file type. For transfers with multiple files, the response is a zip archive.

​
Headers

HeaderDescription
Content-TypeMIME type of the file (or application/zip for multi-file transfers)
Content-Dispositionattachment; filename="original-name.ext"
X-Downloads-RemainingNumber of downloads left before the transfer locks

​
Examples

curl -X GET https://agentdrop-production.up.railway.app/v1/transfers/txfr_abc123/download \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -o report.pdf

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDTransfer does not exist
410GONETransfer expired or download limit reached