Skip to main content
GET
/
v1
/
transfers
List Transfers
curl --request GET \
  --url https://api.agent-drop.com/v1/transfers \
  --header 'Authorization: <authorization>'
{
  "transfers": [
    {}
  ],
  "offset": 123,
  "limit": 123,
  "total": 123,
  "has_more": true
}
Retrieve a paginated list of all transfers associated with your account.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Query Parameters

​
offset
integer
default:"0"
Number of transfers to skip. Used for offset-based pagination.
​
limit
integer
default:"20"
Number of transfers to return. Maximum: 100.
​
status
string
Filter by transfer status. One of: active, expired, deleted.
​
mode
string
Filter by transfer mode. One of: agent-to-agent, agent-to-human, human-to-agent.

​
Response

​
transfers
array
Array of transfer objects.
​
offset
integer
Current offset.
​
limit
integer
Number of items returned.
​
total
integer
Total number of transfers matching the query.
​
has_more
boolean
Whether there are more transfers beyond this page.

​
Examples

curl -X GET "https://api.agent-drop.com/v1/transfers?offset=0&limit=10" \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "transfers": [
    {
      "id": "tr_abc123",
      "status": "active",
      "mode": "agent-to-agent",
      "sender": "research-agent",
      "recipient": "report-agent",
      "files": [{ "name": "data.csv", "size": 245760, "type": "text/csv" }],
      "is_encrypted": true,
      "auto_delete": true,
      "downloads": 0,
      "max_downloads": 10,
      "total_size": 245760,
      "file_count": 1,
      "created_at": "2026-03-22T12:00:00Z",
      "expires_at": "2026-03-23T12:00:00Z"
    },
    {
      "id": "tr_def456",
      "status": "expired",
      "mode": "agent-to-human",
      "sender": "scraper-agent",
      "recipient": "indexer-agent",
      "files": [{ "name": "pages.json", "size": 512000, "type": "application/json" }],
      "is_encrypted": false,
      "auto_delete": false,
      "downloads": 3,
      "max_downloads": 10,
      "total_size": 512000,
      "file_count": 1,
      "created_at": "2026-03-20T08:00:00Z",
      "expires_at": "2026-03-21T08:00:00Z"
    }
  ],
  "total": 2,
  "offset": 0,
  "limit": 10,
  "has_more": false
}
This endpoint returns transfers sent by your account. To check incoming transfers for an agent, use GET /v1/agents/{id}/inbox.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key