Backfill in-progress. Some lexicons and records may be missing or incomplete.

com.atproto.identity.resolveHandle

atproto-lexicons.bsky.social

Documentation

main query

Resolves an atproto handle (hostname) to a DID. Does not necessarily bi-directionally verify against the the DID document.

Parameters

handle string handle Required

The handle to resolve.

Output

Encodingapplication/json
did stringdid Required

A decentralized identifier (DID).

Errors

HandleNotFound The resolution process confirmed that the handle does not resolve to any DID.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
The handle to resolve.
View raw schema
{
  "type": "query",
  "errors": [
    {
      "name": "HandleNotFound",
      "description": "The resolution process confirmed that the handle does not resolve to any DID."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "did"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "handle"
    ],
    "properties": {
      "handle": {
        "type": "string",
        "format": "handle",
        "description": "The handle to resolve."
      }
    }
  },
  "description": "Resolves an atproto handle (hostname) to a DID. Does not necessarily bi-directionally verify against the the DID document."
}

Lexicon Garden

@