List Agents

Retrieve all registered agents for your organization with filtering and pagination.

GET/agents

List all registered agents for your organization.

Requires API key authentication

Query Parameters

Parameter	Type	Required	Description
status	string	optional	Filter by status: active, suspended, deleted
environment	string	optional	Filter by environment: production, staging
search	string	optional	Search by agent name
page	number	optional	Page number. Default: 1
limit	number	optional	Items per page. Default: 20, max: 100

Response

Returns a paginated array of agent objects for the authenticated organization.

Response — 200 OK

{  "data": [    {      "id": "agent_7f3k9x2m",      "name": "Trading Agent Alpha",      "fingerprint": "sha256:a1b2c3d4e5f6...",      "environment": "production",      "status": "active",      "authorized_actions": ["execute_trades"],      "spending_limit": 50000,      "currency": "USD",      "created_at": "2025-01-15T10:30:00Z"    },    {      "id": "agent_9h2j5l8p",      "name": "Support Agent Beta",      "fingerprint": "sha256:f6e5d4c3b2a1...",      "environment": "production",      "status": "active",      "authorized_actions": ["read_tickets", "respond_tickets"],      "spending_limit": 1000,      "currency": "USD",      "created_at": "2025-01-16T14:20:00Z"    }  ],  "pagination": {    "page": 1,    "limit": 20,    "total": 2,    "total_pages": 1  }}

Examples

BASH

curl https://api.alsorn.com/agents?status=active&limit=10 \  -H "Authorization: Bearer YOUR_API_KEY"