Resolve DID

Resolves a Decentralized Identifier (DID) to its DID Document, which contains public keys and verification methods. Supports did:key, did:via, and did:web methods.

GET /v1/via/dids/{did}

Resolve DID

cURL

curl --request GET \
  --url https://api.example.com/v1/via/dids/{did}

200

{
  "@context": [
    "https://www.w3.org/ns/did/v1"
  ],
  "id": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
  "verificationMethod": [
    {
      "id": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
      "publicKeyMultibase": "z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
    }
  ],
  "authentication": [
    "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1"
  ],
  "assertionMethod": [
    "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1"
  ]
}

Path Parameters

did · string · required

Decentralized Identifier (URL-encoded)

Example:

"did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"

Query Parameters

timeout · number

Resolution timeout in milliseconds

Example:

5000

Response

200

application/json

DID Document resolved successfully

@context · string[] · required

JSON-LD context

Example:

["https://www.w3.org/ns/did/v1"]

id · string · required

DID identifier

Example:

"did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"

verificationMethod · object · required

Verification methods (public keys)

Example:

[
  {
    "id": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1",
    "type": "Ed25519VerificationKey2020",
    "controller": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
    "publicKeyMultibase": "z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
  }
]

authentication · string[] · required

Authentication methods

Example:

[
  "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1"
]

assertionMethod · string[] · required

Assertion methods

Example:

[
  "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK#key-1"
]