Skip to main content

Fetch an Avatar

GET 
/:hash

Public, unauthenticated. Returns the stored PNG at the nearest size ≥ s when an avatar is saved; otherwise generates a deterministic avatar from the hash. Never 404s for a well-formed hash unless the caller asks via d=404. A malformed hash is a 400.

Request​

Path parameters

    hash stringrequired

    sha256(lower(trim(email))) — 64 hex chars.

    Example: b1c9e3d2f0a4...f04a

Query parameters

    s integer

    Possible values: >= 16 and <= 512

    Square size in pixels.

    Default value: 80
    d string

    Default when nothing is saved: personas | initials | identicon | bottts | 404 | blank | a URL to 302 to.

    Default value: personas
    f string

    Possible values: [y]

    Force the generated default even if an avatar is saved.

    fmt string

    Possible values: [png, svg]

    svg is only available for generated output.

    Default value: png
    v string

    Opaque cache-buster → immutable caching.

Responses

The avatar image.