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

CURL

Endpoint: GET /wallet-api/wallet/{walletId}/dids | API Reference

Example Request
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 for how to retrieve it.

Header Parameters

  • Authorization: String - Bearer token obtained from the login endpoint. Format: Bearer {token}.
Example Response

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

[
  {
    "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"
  }
]

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.
Last updated on May 6, 2026
Import dids into your walletOverview