GET - Get avatar id by short code

This is an alternative to avatar hotloading, for applications that can’t pass query parameters between the browser and the desktop game.

A unique code can be generated for an avatar. Once created, this code can be used to retrieve the avatar ID during a period of time (1 hour).

The code consists of three letters followed by two numbers (e.g., ABC12) and expires past 1 hour.

Use this endpoint to retrive the avatar for given code

Request

POST https://api.readyplayer.me/v3/avatars/:code

Path Parameters

Name
Type
Description

code

String

Avatar code

Response

{
  "data": {
    "avatarId": "743a7c421b5a830535675049",
    "code": "ABC12"
  }
}

Last updated

Was this helpful?