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-Instance-IDstring nullable

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

Response

Successful Response

Changes

Changed in 5 of the 50 revisions of this API.520

Sep 2, 2026c7c12da5915f12See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Aug 27, 2026359d267dca881See the full diff
- ○
  deleted the header request parameter X-Agent-ID with deprecation
  request-parameter-removed-with-deprecation
Aug 23, 2026b1ad79e918ac1See the full diff
- ○
  header request parameter X-Agent-ID was deprecated
  request-parameter-deprecated
Jul 26, 2026270e233e401c55See the full diff
- ●
  for the query request parameter cursor, the maxLength was set to 1024
  request-parameter-max-length-set
- ●
  added the new ACTIVE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new REVOKED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUSPENDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter status
  new-optional-request-parameter
- ○
  added subschema #1: ConnectedAgentLimits to the ///// response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the ///// response property anyOf list for the response status
  response-property-any-of-removed
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
Jul 14, 20268cc2aed458471See the full diff
- ○
  added the required property /// to the response with the status
  response-required-property-added

Full history