---
title: "List identities"
method: GET
path: "/identity"
tags: ["identity"]
---

# List identities

`GET /identity`

List the team's identities, newest first

## Query parameters

- `page` integer
- `page_size` integer
- `search` string

## Headers

- `Authorization` string, required

## Response `200`

List of identities

- IdentityListIdentitiesResponse200
  - `success` boolean
  - `page` integer
  - `num_pages` integer
  - `page_size` integer
  - `total_count` integer
  - `items` IdentitySummary[]
    - `uuid` string
    - `name` string
    - `created_at` string, date-time
    - `audio_url` string, uri, nullable — URL of the first voice sample, if any
    - `visibility` 'team' | 'global'
    - `identity_type` 'person' | 'brand'
    - `notes` string, nullable
    - `voice_profile_id` string, nullable
    - `updated_at` string, date-time
    - `project_count` integer

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-26** `5e92bebbaf1f` — 17 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - added the new optional `query` request parameter `search`
  - added the optional property `items/items/audio_url` to the response with the `200` status
  - …13 more

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/identity/get.md)

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)