Skip to main content
An alias is a short, human-friendly public name that points to a Talaria DID. Use this endpoint when a person gives your application an alias instead of a complete did:talaria:... identifier. Alias lookup is read-only and requires no signature.

Before you use an alias

Aliases improve usability, but the DID remains the cryptographic identity. Resolve the returned DID before selecting keys or sending a message. The Directory normalizes aliases to lowercase. Valid aliases use letters, digits, _, ., @, and -, with a maximum length of 64 characters.

Request

string
required
The complete public alias. URL-encode it if it contains characters that are not safe in a URL path.

Response

string
required
The normalized alias that was resolved.
string
required
The Talaria DID that currently owns the alias.

Next step

Resolve the returned DID:

Straight to the point

  • Authentication: none
  • Body: none
  • Success: 200
  • Unknown alias: 404