Skip to main content
GET
/
v1
/
api-keys
List API Keys
curl --request GET \
  --url https://api.agent-drop.com/v1/api-keys \
  --header 'Authorization: <authorization>'
{
  "keys": [
    {}
  ],
  "keys[].id": "<string>",
  "keys[].name": "<string>",
  "keys[].prefix": "<string>",
  "keys[].last_used_at": "<string>",
  "keys[].transfer_count": 123,
  "keys[].created_at": "<string>"
}
Retrieve all API keys associated with your account. Returns key metadata only, full key values are never shown after creation.
Full API key values are only returned once, in the create-api-key response. If you lose a key, revoke it and create a new one.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Response

​
keys
array
Array of API key objects.

​
Key Object

​
keys[].id
string
The key ID, used for revocation.
​
keys[].name
string
The descriptive name you assigned to this key.
​
keys[].prefix
string
The first characters of the key (e.g. agd_live_xxxx). Useful for identifying which key is in use.
​
keys[].last_used_at
string
ISO 8601 timestamp of the last time this key was used. null if never used.
​
keys[].transfer_count
integer
Total number of transfers created with this key.
​
keys[].created_at
string
ISO 8601 creation timestamp.

​
Examples

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

​
Response

{
  "keys": [
    {
      "id": "key_a1b2c3d4",
      "name": "production-agent",
      "prefix": "agd_live_xxxx",
      "last_used_at": "2026-03-28T09:15:00Z",
      "transfer_count": 142,
      "created_at": "2026-03-10T08:00:00Z"
    },
    {
      "id": "key_e5f6g7h8",
      "name": "staging-tests",
      "prefix": "agd_live_yyyy",
      "last_used_at": null,
      "transfer_count": 0,
      "created_at": "2026-03-25T16:00:00Z"
    }
  ]
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key