Skip to main content
GET
/
v1
/
transfers
/
{id}
Get Transfer
curl --request GET \
  --url https://agentdrop-production.up.railway.app/v1/transfers/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>",
  "sender": "<string>",
  "recipient": "<string>",
  "files": [
    {}
  ],
  "max_downloads": 123,
  "download_count": 123,
  "expires_at": "<string>",
  "created_at": "<string>"
}

​
Get Transfer

Retrieve the status, metadata, and file list for a specific transfer. Use this to check if a transfer is still active before downloading.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Path Parameters

​
id
string
required
The transfer ID. Example: txfr_abc123

​
Response

​
id
string
Unique transfer ID.
​
status
string
Current status: active, expired, deleted, or downloaded.
​
sender
string
The sender identifier.
​
recipient
string
The recipient identifier.
​
files
array
Array of file objects with name, size, and type.
​
max_downloads
integer
Maximum allowed downloads.
​
download_count
integer
Number of times this transfer has been downloaded.
​
expires_at
string
ISO 8601 expiry timestamp.
​
created_at
string
ISO 8601 creation timestamp.

​
Examples

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

​
Response

{
  "id": "txfr_abc123",
  "status": "active",
  "sender": "data-pipeline",
  "recipient": "analysis-agent",
  "files": [
    { "name": "report.pdf", "size": 1048576, "type": "application/pdf" }
  ],
  "max_downloads": 10,
  "download_count": 2,
  "expires_at": "2026-03-23T12:00:00Z",
  "created_at": "2026-03-22T12:00:00Z"
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDTransfer does not exist or has been deleted