Skip to main content


Our free HTTP-API is the easiest way to use Avatars. Just use the following URL as image source.

Replace :sprites with male, female, human, identicon, initials, bottts, avataaars, jdenticon, gridy or micah. The value of :seed can be anything you like - but don't use any sensitive or personal data here!


We provide a large number of avatar styles from different designers. The designs are licensed under different licenses that the designers can choose themselves. Some licenses require attribution. For a quick overview we have created an license overview for you.


Most options can be specified using the query string. Note that you have to encode the values.

The following URL for example sets a blue background:

And this URL sets the mood option for the avatar style male to happy and sad:[]=happy&mood[]=sad


The API also supports versioning!

Always use the latest version:

Use a specific version (4.6 for example):

Currently supported versions: 4.4, 4.5, 4.6, 4.7, 4.8 and 4.9.