---
title: "List DIDs"
description: "Retrieve all DIDs registered in a specific wallet. The response includes the DID string, its method, the associated key ID, and optional alias."
stack: "Community Stack (open source) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/community-stack/wallet/did-management/list-dids
generated: 2026-07-20
---
# List DIDs

Retrieve all DIDs registered in a specific wallet. The response includes the DID string, its method, the associated key ID, and optional alias.

## List DIDs

**Option: CURL**

**Endpoint:** `GET /wallet-api/wallet/{walletId}/dids` | [API Reference](https://wallet.demo.walt.id/swagger/index.html#/DIDs/get_wallet_api_wallet__wallet__dids)

##### Example Request

```bash
curl -X 'GET' \
  'http://0.0.0.0:7001/wallet-api/wallet/{walletId}/dids' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {token}'
```

**Path Parameters**

- `walletId`: _String_ - The ID of the wallet to list DIDs from. See [Accounts & Wallets](https://docs.walt.id/community-stack/wallet/accounts-wallets.md#retrieve-wallet-id) for how to retrieve it.

**Header Parameters**

- `Authorization`: _String_ - Bearer token obtained from the [login endpoint](https://docs.walt.id/community-stack/wallet/authentication/email-password-auth.md#login). Format: `Bearer {token}`.

---

##### Example Response

The API returns a list of DID objects registered in the wallet.

```json
[
  {
    "did": "did:jwk:eyJrdHkiOiJFQyIsImNydiI6IlAtMjU2Iiwia2lkIjoib05kaHFwWlV5TnZRSHdOLS1IOWFxQmJuTnRPYWpSN056bVJzNl8wdWtqZyIsIngiOiJtZTdKbWE3S05hejNMM3N6OVNlRTdqbDkxYW1UbTktd1Y4dXBJcllJYVJRIiwieSI6ImxFQWVDNHRkcnl4MnBCUmJleHlQcE52ejdxSk9wWFBVS3ZKSnZoQkh6QUEifQ",
    "alias": "Onboarding",
    "document": "{\"@context\":[\"https://www.w3.org/ns/did/v1\",\"https://w3id.org/security/suites/jws-2020/v1\"],\"id\":\"did:jwk:eyJrdHkiOiJFQyIsImNydiI6IlAtMjU2Iiwia2lkIjoib05kaHFwWlV5TnZRSHdOLS1IOWFxQmJuTnRPYWpSN056bVJzNl8wdWtqZyIsIngiOiJtZTdKbWE3S05hejNMM3N6OVNlRTdqbDkxYW1UbTktd1Y4dXBJcllJYVJRIiwieSI6ImxFQWVDNHRkcnl4MnBCUmJleHlQcE52ejdxSk9wWFBVS3ZKSnZoQkh6QUEifQ\",\"verificationMethod\":[{\"id\":\"did:jwk:...#0\",\"type\":\"JsonWebKey2020\",\"controller\":\"did:jwk:...\",\"publicKeyJwk\":{\"kty\":\"EC\",\"crv\":\"P-256\",\"kid\":\"oNdhqpZUyNvQHwN--H9aqBbnNtOajR7NzmRs6_0ukjg\",\"x\":\"me7Jma7KNaz3L3sz9SeE7jl91amTm9-wV8upIrYIaRQ\",\"y\":\"lEAeC4tdryx2pBRbexyPpNvz7qJOpXPUKvJJvhBHzAA\"}}],\"assertionMethod\":[\"did:jwk:...#0\"],\"authentication\":[\"did:jwk:...#0\"],\"capabilityInvocation\":[\"did:jwk:...#0\"],\"capabilityDelegation\":[\"did:jwk:...#0\"],\"keyAgreement\":[\"did:jwk:...#0\"]}",
    "keyId": "oNdhqpZUyNvQHwN--H9aqBbnNtOajR7NzmRs6_0ukjg",
    "default": true,
    "createdOn": "2026-04-29T05:53:48.719808Z"
  }
]
```

**Note:**

  The `document` field is returned as an escaped JSON string. Parse it to work with the DID document structure.

Each object in the response includes:

- `did`: _String_ - The full DID string.
- `alias`: _String_ - An optional human-readable label assigned to the DID.
- `document`: _String_ - The resolved DID document as an escaped JSON string, containing verification methods, assertion methods, authentication, capability invocation/delegation, and key agreement references.
- `keyId`: _String_ - The ID of the cryptographic key associated with this DID, as stored in the wallet's key management.
- `default`: _Boolean_ - Whether this is the wallet's default DID, used automatically when no specific DID is provided in credential operations.
- `createdOn`: _String_ - ISO 8601 timestamp of when the DID was created in the wallet.