> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirebox.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agent Identities

> Retrieve all agent identities registered within your organization.

### Query Parameters

<ParamField query="limit" type="integer" default="50">
  Number of identities to return (1–100).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of records to skip for pagination.
</ParamField>

### Response

Returns an array of identity objects.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.wirebox.sh/api/v1/identities?limit=20" \
    -H "Authorization: Bearer $WIREBOX_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "ident_01J8ABC123XYZ",
      "agent_handle": "eva",
      "display_name": "Eva Customer Support",
      "description": "Customer triage agent",
      "mailbox_address": "eva@wireboxmail.com",
      "created_at": "2026-09-11T10:00:00Z",
      "updated_at": "2026-09-11T10:00:00Z"
    }
  ]
  ```
</ResponseExample>