---
title: "List DIDs"
method: GET
path: "/identifiers"
tags: ["Dids"]
---

# List DIDs

`GET /identifiers`

Returns a page of local DID records. Filters are applied before
pagination. `role` is parsed from `MANAGED` or `EXTERNAL`; `expand`
accepts `document`, `keys`, or `all` as a comma-separated query value.

## Query parameters

- `method` string
- `role` DidRole — unresolved $ref
- `alias` string
- `search` string
- `includeDeactivated` boolean
- `includeDeleted` boolean
- `page` integer
- `size` integer
- `sort` 'createdAt' | 'updatedAt' | 'did' | 'method' | 'alias'
- `sortDirection` 'ASC' | 'DESC'
- `expand` string[]

## Parameters

- `./common-components.yml#/components/parameters/CorrelationId` — unresolved $ref

## Response `200`

Paginated list of DIDs.

- DidListResponse — Paginated list of DIDs.
  - `items` Did[], required — unresolved $ref
  - `page` PageMeta, required — unresolved $ref

## Other responses

- `401` — unresolved $ref
- `403` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/sphereon-opensource/apis/did-rest-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/did-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/did-rest-api/revisions/d575fc307e80/schema)