Identity

Identity endpoints resolve ATProto identifiers. Both routes proxy upstream services verbatim, making them safe to call from browser clients without additional CORS configuration.

GET /identity/resolve

Resolve a handle to a DID via bsky.social.

Proxies com.atproto.identity.resolveHandle. The response shape mirrors the ATProto lexicon.

Query parameters

NameTypeRequiredDescription
handle string yes Tangled or ATProto handle to resolve.

GET /identity/did/{did}

Fetch a DID document for did:plc or did:web identifiers.

did:plc resolves via plc.directory. did:web resolves via https://{host}/.well-known/did.json. Other DID methods return 400.

Path parameters

NameTypeDescription
did string A did:plc:… or did:web:… identifier.