☰
DFK Developers

Pet Metadata & Image API

You can use the following endpoints to access Pet metadata and static images of DFK Pets by Pet ID.

Pet Metadata

Returns metadata about the requested Pet

GET https://pets.defikingdoms.com/token/{id}

Example - https://pets.defikingdoms.com/token/1

Path Parameters

NameTypeDescription
*integer

The ID of the requested Pet.

E.g.: 1234, 1000000001234, 2000000001234

Note: Pets native to Crystalvale have IDs that are padded by 1000000000000 (one trillion), and those native to Serendale 2.0 are padded by 2000000000000 (two trillion).

Pet Static Image

Returns a static, transparent png image of the requested Pet

GET https://pets.defikingdoms.com/image/{id}?{queryParams}

Examples

Full Image - https://pets.defikingdoms.com/image/1

No Frame - https://pets.defikingdoms.com/image/1?frame=false

Path Parameters

NameTypeDescription
id*integer

The ID of the requested Pet.

E.g.: 1234, 1000000001234, 2000000001234

Note: Pets native to Crystalvale have IDs that are padded by 1000000000000 (one trillion), and those native to Serendale 2.0 are padded by 2000000000000 (two trillion).

Query Parameters

NameTypeDescription
frameBoolean

Default: true

Includes the Pet frame in the image response.

backgroundBoolean

Default: true

Includes the Pet background in the image response.