Customers

List customers

List customers who have authorized an agent to act for them

get/customers

Query parameters

cursorstring

Cursor from the previous page.

limitinteger

Maximum results per page.

status'active' | 'revoked' | 'all'

Filter by connection state. Active returns any non-revoked connection (including suspended and expired). Revoked returns customers whose access was revoked. All returns both.

Headers

X-Agent-IDstring nullable

Deprecated: agent identity comes from the credential. Sending this header with a party API key or user credential returns 403 agent_credential_required.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Response

Successful Response