---
title: "List identities"
method: GET
path: "/api/v2/identities"
tags: ["Identities"]
---

# List identities

`GET /api/v2/identities`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v2/identities`
- Auth: HTTP bearer

Retrieve a list of identities with filtering and pagination.

**Important notes:**
- Supports filtering by name, IDs, and date range
- Results can be sorted and paginated

`identities[].id` feeds documents_index, documents_create, documents_update, identities_destroy and
numbers_purchase_update. When `documents_count` is above zero, documents_index lists those documents
by `identity_id`.

## Query parameters

- `ids` string
- `name` string
- `created_at_from` string, date
- `created_at_to` string, date
- `order_by` string
- `order` 'asc' | 'desc'
- `page` integer
- `per_page` integer

## Response `200`

returns identities with documents count

- object
  - `identities` object[], required: List of identities
    - `id` integer, required: Identity identifier
    - `name` string, required: Identity name
    - `user_id` integer, required: Owner user ID
    - `created_at` string, required: Creation timestamp
    - `persistence_status` string, required
    - `is_default` boolean, required
    - `documents_count` integer, required: Number of documents in this identity
  - `pagination` object, required: Pagination metadata
    - `total` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages
    - `current_page` integer, required: Current page number
    - `per_page` integer, required: Items per page

## Other responses

- `401`: returns unauthorized

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)