Response codes & types

The Avatar API uses conventional HTTP response codes to indicate the success or failure of an API request.

• Codes in the 2xx range indicate success.

• Codes in the 4xx range indicate a failure given the information provided.

• Codes in the 5xx range indicate an error with Enoch Player Me services.

Timestamps return in UTC time.

Status Code	Description
200 - OK	Everything worked as expected.
400 - Bad Request	The request was unacceptable, often due to missing a required parameter.
401 - Unauthorized	Unauthorized request for a secured endpoint.
402 - Request Failed	The parameters were valid but the request failed.
403 - Forbidden	The authorized user doesn't have permission to perform the request.
404 - Not Found	The requested resource doesn't exist.
5xx - Server Errors	Something went wrong on Enoch's end.

Avatar file format

All 3D avatars are delivered in GLTF format.

The API returns standardized .gltf or .png files for the 3D and 2D avatars, or JSON-encoded responses. Only default HTTP response codes are used.

glTF is a standard file format for three-dimensional scenes and models. A glTF file uses one of two possible file extensions: .gltf or .glb. Both .gltf and .glb files may reference external binary and texture resources