Skip to main content
GET
List agents

Authorizations

Authorization
string
header
required

API key (pk_test_* or pk_live_), JWT session, agent token (agent_), Ed25519 session (sess_), or portal token (portal_).

Query Parameters

parent_account_id
string<uuid>
status
enum<string>
Available options:
active,
frozen,
suspended,
revoked
kya_tier
integer | null
Required range: 0 <= x <= 3
connected
enum<string>

Filter to agents currently holding an SSE session

Available options:
true,
false
page
integer
default:1
limit
integer
default:50
Required range: x <= 200

Response

200 - application/json

Paginated agents

data
object[]
required
pagination
object
required