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

Name	Type	Description
*	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).

200: OK

304: Not Modified

404: Not Found

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

Name	Type	Description
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

Name	Type	Description
frame	Boolean	Default: true Includes the Pet frame in the image response.
background	Boolean	Default: true Includes the Pet background in the image response.

200: OK

304: Not Modified

404: Not Found