Skip to main content
GET
/
v1
/
transfers
List Transfers
curl --request GET \
  --url https://agentdrop-production.up.railway.app/v1/transfers \
  --header 'Authorization: <authorization>'
{
  "data": [
    {}
  ],
  "page": 123,
  "limit": 123,
  "total": 123
}

​
List Transfers

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

​
page
integer
default:"1"
Page number for pagination.
​
limit
integer
default:"20"
Number of transfers per page. Maximum: 100.

​
Response

​
data
array
Array of transfer objects.
​
page
integer
Current page number.
​
limit
integer
Items per page.
​
total
integer
Total number of transfers.

​
Examples

curl -X GET "https://agentdrop-production.up.railway.app/v1/transfers?page=1&limit=10" \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

​
Response

{
  "data": [
    {
      "id": "txfr_abc123",
      "status": "active",
      "sender": "research-agent",
      "recipient": "report-agent",
      "files": [{ "name": "data.csv", "size": 245760, "type": "text/csv" }],
      "created_at": "2026-03-22T12:00:00Z",
      "expires_at": "2026-03-23T12:00:00Z"
    },
    {
      "id": "txfr_def456",
      "status": "expired",
      "sender": "scraper-agent",
      "recipient": "indexer-agent",
      "files": [{ "name": "pages.json", "size": 512000, "type": "application/json" }],
      "created_at": "2026-03-20T08:00:00Z",
      "expires_at": "2026-03-21T08:00:00Z"
    }
  ],
  "page": 1,
  "limit": 10,
  "total": 2
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key