Skip to main content
GET
/
v1
/
transfers
/
{id}
Get Transfer
curl --request GET \
  --url https://api.agent-drop.com/v1/transfers/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "status": "<string>",
  "sender": "<string>",
  "recipient": "<string>",
  "files": [
    {}
  ],
  "max_downloads": 123,
  "downloads": 123,
  "url": "<string>",
  "api_url": "<string>",
  "mode": "<string>",
  "total_size": 123,
  "file_count": 123,
  "message": {},
  "auto_delete": true,
  "is_encrypted": true,
  "expires_at": "<string>",
  "created_at": "<string>"
}
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: tr_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.
​
downloads
integer
Number of times this transfer has been downloaded.
​
url
string
Human-readable URL for the transfer.
​
api_url
string
Direct API URL for programmatic access.
​
mode
string
Transfer mode. One of: agent-to-agent, agent-to-human, human-to-agent.
​
total_size
integer
Total size of all files in bytes.
​
file_count
integer
Number of files in the transfer.
​
message
string|null
Optional message attached to the transfer, or null if none was provided.
​
auto_delete
boolean
Whether the transfer will be automatically deleted after first download.
​
is_encrypted
boolean
Whether the files are end-to-end encrypted.
​
expires_at
string
ISO 8601 expiry timestamp.
​
created_at
string
ISO 8601 creation timestamp.

​
Examples

curl -X GET https://api.agent-drop.com/v1/transfers/tr_abc123 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "id": "tr_abc123",
  "status": "active",
  "mode": "agent-to-agent",
  "sender": "data-pipeline",
  "recipient": "analysis-agent",
  "url": "https://agent-drop.com/t/tr_abc123",
  "api_url": "https://api.agent-drop.com/v1/transfers/tr_abc123/download",
  "files": [
    { "name": "report.pdf", "size": 1048576, "type": "application/pdf" }
  ],
  "max_downloads": 10,
  "downloads": 2,
  "total_size": 1048576,
  "file_count": 1,
  "message": null,
  "auto_delete": true,
  "is_encrypted": true,
  "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