List Transfers
curl --request GET \
--url https://api.agent-drop.com/v1/transfers \
--header 'Authorization: <authorization>'import requests
url = "https://api.agent-drop.com/v1/transfers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.agent-drop.com/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.agent-drop.com/v1/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.agent-drop.com/v1/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.agent-drop.com/v1/transfers")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agent-drop.com/v1/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"transfers": [
{}
],
"offset": 123,
"limit": 123,
"total": 123,
"has_more": true
}Transfers
List Transfers: Enumerate File Transfer History
List AgentDrop transfers your account has sent or received with pagination and filters for status, recipient, and date. Returns newest-first paginated results.
GET
/
v1
/
transfers
List Transfers
curl --request GET \
--url https://api.agent-drop.com/v1/transfers \
--header 'Authorization: <authorization>'import requests
url = "https://api.agent-drop.com/v1/transfers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.agent-drop.com/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.agent-drop.com/v1/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.agent-drop.com/v1/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.agent-drop.com/v1/transfers")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agent-drop.com/v1/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"transfers": [
{}
],
"offset": 123,
"limit": 123,
"total": 123,
"has_more": true
}Retrieve a paginated list of all transfers associated with your account.
Request
Headers
string
required
Bearer token. Example:
Bearer agd_live_xxxxxxxxxxxxxxxxxxxxQuery Parameters
integer
default:"0"
Number of transfers to skip. Used for offset-based pagination.
integer
default:"20"
Number of transfers to return. Maximum: 100.
string
Filter by transfer status. One of:
active, expired, deleted.string
Filter by transfer mode. One of:
agent-to-agent, agent-to-human, human-to-agent.Response
array
Array of transfer objects.
integer
Current offset.
integer
Number of items returned.
integer
Total number of transfers matching the query.
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 = requests.get(
"https://api.agent-drop.com/v1/transfers",
headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
params={"offset": 0, "limit": 10},
)
data = response.json()
for transfer in data["transfers"]:
print(f"{transfer['id']} - {transfer['status']}")
const response = await fetch(
"https://api.agent-drop.com/v1/transfers?offset=0&limit=10",
{
headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
}
);
const { transfers, has_more } = await response.json();
transfers.forEach((t) => console.log(`${t.id} - ${t.status}`));
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
| Status | Code | Description |
|---|---|---|
401 | UNAUTHORIZED | Invalid or missing API key |
