Skip to main content
GET
/
did
/
resolve
/
{did}
Resolve DID
curl --request GET \
  --url https://api.example.com/did/resolve/{did}
{
  "@context": [
    "https://www.w3.org/ns/did/v1",
    "https://w3id.org/security/suites/ed25519-2020/v1"
  ],
  "id": "did:via:humanos:org-abc",
  "verificationMethod": [
    {
      "id": "did:via:humanos:org-abc#key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:via:humanos:org-abc",
      "publicKeyMultibase": "z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"
    }
  ],
  "authentication": [
    "did:via:humanos:org-abc#key-1"
  ],
  "assertionMethod": [
    "did:via:humanos:org-abc#key-1"
  ],
  "keyAgreement": [
    "did:via:humanos:org-abc#key-2"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.humanos.tech/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
API-Version
string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-03"

Path Parameters

​
did
string
required

The DID string to resolve

Example:

"did:web:humanos.tech:humanos:org-abc123"

Response

DID Document

​
@context
string[]
required

JSON-LD contexts. MUST include the DID core v1 context.

Example:
[
  "https://www.w3.org/ns/did/v1",
  "https://w3id.org/security/suites/ed25519-2020/v1"
]
​
id
string
required

The DID this document describes

Example:

"did:via:humanos:org-abc"

​
verificationMethod
object[]
required

Verification methods declared for this DID

​
authentication
string[]

Verification method IDs authorized for authentication

Example:
["did:via:humanos:org-abc#key-1"]
​
assertionMethod
string[]

Verification method IDs authorized for making assertions

Example:
["did:via:humanos:org-abc#key-1"]
​
keyAgreement
string[]

Verification method IDs authorized for key agreement

Example:
["did:via:humanos:org-abc#key-2"]