Potservers API

Dino stats, map locations and quests for Path of Titans. Free to use, no API key.

Base URL: https://potservers.net/api/v1
Rate limit: 120/min per IP
Format: JSON

Make your first request

Get the full dino list. Choose a language, then copy the request.

Request

curl --compressed https://potservers.net/api/v1/dinos

Results are in data; meta includes the count and attribution. See the response.

Dinos

Official and modded dinos, with stats, abilities and growth curves.

GETGet the dino list/api/v1/dinos

Every dino, official and modded, sorted by name.

ReturnsA list of DinoSummary in data.

Request

curl --compressed https://potservers.net/api/v1/dinos

Example response, trimmed

{
  "data": [
    {
      "id": "achillobator",
      "name": "Achillobator",
      "url": "https://potservers.net/api/v1/dinos/achillobator",
      "diet": "carnivore",
      "modded": false,
      "icon_url": "https://potservers.net/api/dinos/assets/icons/achillobator/character_icon.png?v=babf14dd8235"
    },
    {
      "id": "absentia_acro",
      "name": "Acrocanthosaurus",
      "url": "https://potservers.net/api/v1/dinos/absentia_acro",
      "diet": "carnivore",
      "modded": true,
      "icon_url": "https://potservers.net/api/dinos/assets/mods/icons/absentia_acro/character_icon.png?v=babf14dd8235"
    },
    ... 162 more
  ],
  "meta": {
    "count": 164,
    "updated_at": "2026-10-18T19:29:01Z",
    "attribution": "Data from Potservers (https://potservers.net). Unofficial; Path of Titans belongs to Alderon Games."
  }
}

GETGet a dino/api/v1/dinos/{id}

Everything about one dino: stats, subspecies, abilities and growth curves.

Parameter	Type	Description
`id`path	string	Dino id, from the dino list.

ReturnsOne Dino in data.

Request

curl --compressed https://potservers.net/api/v1/dinos/tyrannosaurus

Example response, trimmed

{
  "data": {
    "id": "tyrannosaurus",
    "name": "Tyrannosaurus",
    "url": "https://potservers.net/api/v1/dinos/tyrannosaurus",
    "page_url": "https://potservers.net/dinos#tyrannosaurus",
    "modded": false,
    "mod": null,
    "diet": "carnivore",
    "aquatic": false,
    "flying": false,
    "group_slots": 5,
    "nest_materials": [
      "bones",
      "rocks",
      ... 1 more
    ],
    "icon_url": "https://potservers.net/api/dinos/assets/icons/tyrannosaurus/character_icon.png?v=babf14dd8235",
    "stats": {
      "health": {
        "name": "HP",
        "value": 850,
        "unit": null,
        "better": "higher"
      },
      "combat_weight": {
        "name": "Combat Weight",
        "value": 5500,
        "unit": null,
        "better": "higher"
      },
      "armor": {
        "name": "Armor",
        "value": 1.1,
        "unit": null,
        "better": "higher"
      },
      "heal_rate": {
        "name": "Heal Rate",
        "value": 1.9,
        "unit": null,
        "better": "higher"
      },
      ... 25 more
    },
    "subspecies": [
      {
        "id": "rex",
        "name": "Rex",
        "description": "+25% Knockback Resist",
        "unlock_cost": 500
      },
      {
        "id": "bataar",
        "name": "Bataar",
        "description": "+3% Attack Damage",
        "unlock_cost": 500
      },
      ... 1 more
    ],
    "stats_changed_at": "2026-10-06T01:14:18Z",
    "stats_changed_at_approximate": false,
    "live_hotfix": null,
    "abilities": [
      {
        "id": "bite",
        "name": "Bite",
        "description": "Causes high damage. Clamped targets can be chewed on and will receive Bone Break.",
        "slot": "other",
        "slot_name": "Other",
        "unlock_cost": null,
        "unlocked_by_default": true,
        "icon_url": "https://potservers.net/api/dinos/assets/icons/tyrannosaurus/bite.png?v=babf14dd8235",
        "metrics": [
          {
            "key": "clamp_damage",
            "name": "Clamp Damage",
            "value": 20,
            "unit": null,
            "kind": "damage",
            "display_value": null,
            "condition": null,
            "scope": null,
            "note": null
          },
          {
            "key": "clamp_bone_break_amount",
            "name": "Conditional Fracture",
            "value": 7.5,
            "unit": null,
            "kind": "fracture",
            "display_value": null,
            "condition": "Conditional",
            "scope": null,
            "note": "Fracture buildup per hit, before target modifiers. Requires additional effect conditions that have not been resolved ..."
          },
          ... 2 more
        ],
        "sub_abilities": []
      },
      {
        "id": "clamp",
        "name": "Clamp",
        "description": "Bite and hold onto enemies for as long as your stamina allows, can move and drag them around. Immune to knockback whi...",
        "slot": "other",
        "slot_name": "Other",
        "unlock_cost": 600,
        "unlocked_by_default": true,
        "icon_url": "https://potservers.net/api/dinos/assets/icons/tyrannosaurus/clamp.png?v=babf14dd8235",
        "metrics": [
          {
            "key": "carry_weight",
            "name": "Carry Weight",
            "value": 2700,
            "unit": null,
            "kind": "carry_weight",
            "display_value": null,
            "condition": null,
            "scope": null,
            "note": null
          },
          {
            "key": "cooldown",
            "name": "Cooldown",
            "value": 10,
            "unit": "s",
            "kind": "cooldown",
            "display_value": null,
            "condition": null,
            "scope": null,
            "note": null
          },
          ... 6 more
        ],
        "sub_abilities": []
      },
      ... 19 more
    ],
    "curves": [
      {
        "id": "core",
        "name": "Core",
        "rows": [
          {
            "id": "Tyrannosaurus.Core.Armor",
            "name": "Armor",
            "adult_value": 1.1,
            "points": [
              {
                "x": 1,
                "y": 1.1
              },
              {
                "x": 5,
                "y": 1.1
              }
            ]
          },
          {
            "id": "Tyrannosaurus.Core.BleedingHealRate",
            "name": "Bleeding heal rate",
            "adult_value": 0.032,
            "points": [
              {
                "x": 1,
                "y": 0.032
              },
              {
                "x": 5,
                "y": 0.032
              }
            ]
          },
          ... 58 more
        ]
      },
      {
        "id": "combat",
        "name": "Combat",
        "rows": [
          {
            "id": "Tyrannosaurus.BiteBoneBreakAmount",
            "name": "Bite bone break amount",
            "adult_value": 0,
            "points": [
              {
                "x": 1,
                "y": 0
              },
              {
                "x": 5,
                "y": 0
              }
            ]
          },
          {
            "id": "Tyrannosaurus.BiteClampBoneBreakAmount",
            "name": "Bite clamp bone break amount",
            "adult_value": 7.5,
            "points": [
              {
                "x": 1,
                "y": 7.5
              },
              {
                "x": 5,
                "y": 7.5
              }
            ]
          },
          ... 115 more
        ]
      },
      ... 1 more
    ]
  },
  "meta": {
    "updated_at": "2026-10-18T19:29:01Z",
    "attribution": "Data from Potservers (https://potservers.net). Unofficial; Path of Titans belongs to Alderon Games."
  }
}

Response fields

DinoSummary

Field	Type	Description
`id`	string	Dino id.
`name`	string	Name.
`url`	URL	Its full data in the API.
`diet`	string	carnivore or herbivore.
`modded`	boolean	True for community mod dinos.
`icon_url`	URL or null	Portrait (PNG).

Dino

Field	Type	Description
`id`	string	Dino id.
`name`	string	Name.
`url`	URL	This dino in the API.
`page_url`	URL	This dino on potservers.net.
`modded`	boolean	True for community mod dinos.
`mod`	DinoMod or null
`diet`	string	carnivore or herbivore.
`aquatic`	boolean	Lives in or near water.
`flying`	boolean	Can fly.
`group_slots`	integer	Group slots it takes.
`nest_materials`	list of string	Map item types its nest needs, matching marker ids in map data.
`icon_url`	URL or null	Portrait (PNG).
`stats`	object of Stats	Adult stats by id, such as health or sprint_speed. Each one says its name, unit and whether higher is better.
`subspecies`	list of Subspecies	Subspecies it can take.
`stats_changed_at`	date-time or null	When its stats last changed.
`stats_changed_at_approximate`	boolean	True when that date is only a rough floor.
`live_hotfix`	LiveHotfix or null
`abilities`	list of Ability	Its abilities, starting ones first.
`curves`	list of CurveTable	Growth curves: how each value grows from hatchling to adult.

Stat

Field	Type	Description
`name`	string	Name, as on the site.
`value`	number	The adult value.
`unit`	string or null	Unit, or null for a plain number. One of `km/h`, `m`, `min`, `/s`.
`better`	string	Whether a bigger or smaller number is better. One of `higher`, `lower`.

DinoMod

Field	Type	Description
`name`	string or null	Mod name.
`sku`	string or null	The mod's id in the game's mod browser.
`version`	integer or null	Mod version the data comes from.
`author`	string or null	Mod author, when known.

Subspecies

Field	Type	Description
`id`	string	Subspecies id.
`name`	string	Name.
`description`	string or null	What it changes, such as "+25% Knockback Resist".
`unlock_cost`	number or null	Price in Marks.

LiveHotfixSet when official servers run different values than the game files.

Field	Type	Description
`captured_at`	date-time	When the live values were read.
`curve_rows`	list of string	Curves the live balance patch changes.

Ability

Field	Type	Description
`id`	string	Ability id.
`name`	string	Name.
`description`	string or null	The game's description.
`slot`	string	Slot it goes in. One of `head`, `front_limb`, `back_limb`, `legs`, `tail`, `hide`, `senses`, `metabolism`, `voice`, `passives`, `other`.
`slot_name`	string	The slot as shown in game.
`unlock_cost`	number or null	Price in Marks, or null if it comes free.
`unlocked_by_default`	boolean	Owned from the start.
`icon_url`	URL or null	Icon (PNG).
`metrics`	list of Metric	Its numbers, most important first.
`sub_abilities`	list of Ability	Abilities that come with this one.

Metric

Field	Type	Description
`key`	string	The game's internal name for the number.
`name`	string	Name, as on the site.
`value`	number
`unit`	string or null	Unit, or null for a plain number. One of `%`, `%/s`, `/s`, `s`, `m`.
`kind`	string or null	What sort of number it is. One of `damage`, `bone_break`, `fracture`, `bleed`, `venom`, `toxin`, `knockback`, `stamina_cost`, `cooldown`, `range`, `carry_weight`, `hit_ramp`, `full_charge`.
`display_value`	string or null	Text to show instead of the value, such as "Can trigger", or a hit ramp listed hit by hit ("4 → 12 → 20 → 28 → 36 → 44 · 30 s buff").
`condition`	string or null	When it applies.
`scope`	string or null	How the hit has to land, when that matters.
`note`	string or null	A short explanation.

CurveTable

Field	Type	Description
`id`	string	core, combat or multiplier.
`name`	string	Name.
`rows`	list of CurveRow

CurveRow

Field	Type	Description
`id`	string	The game's internal name.
`name`	string	Name.
`adult_value`	number or null	The value when fully grown. Null for the few rows that are not by growth stage.
`points`	list of CurvePoint	Points on the curve. Values in between change in a straight line.

CurvePoint

Field	Type	Description
`x`	number	Growth stage: 1 (hatchling) to 5 (adult), or 0 to 4 for a few modded dinos. A few rows use another input, such as armor or level.
`y`	number	The value at that stage.

Maps

Gondwa, Panjura and Riparia, including markers, regions and map images.

GETGet a map/api/v1/maps/{map}

Everything on one map: items, regions, landmarks, flight paths and images. Every position comes in map units and as a game position.

Parameter	Type	Description
`map`path	string	gondwa, panjura or riparia. One of `gondwa`, `panjura`, `riparia`.

ReturnsOne Map in data.

Request

curl --compressed https://potservers.net/api/v1/maps/riparia

Example response, trimmed

{
  "data": {
    "id": "riparia",
    "name": "Riparia",
    "url": "https://potservers.net/api/v1/maps/riparia",
    "page_url": "https://potservers.net/map?map=Riparia",
    "updated_at": "2026-10-18T19:31:19Z",
    "coordinates": {
      "size": 500,
      "origin": "top_left",
      "world_unit": "cm",
      "world_bounds": {
        "min_x": -257650,
        "min_y": -257650,
        "max_x": 257650,
        "max_y": 257650
      },
      "meters_per_unit": 10.306,
      "meters_per_unit_y": 10.306
    },
    "images": [
      {
        "size": 400,
        "format": "jpeg",
        "url": "https://potservers.net/api/v1/maps/riparia/image?size=400&format=jpeg&v=d3d6cccf6bac"
      },
      {
        "size": 800,
        "format": "jpeg",
        "url": "https://potservers.net/api/v1/maps/riparia/image?size=800&format=jpeg&v=d3d6cccf6bac"
      },
      ... 5 more
    ],
    "markers": [
      {
        "id": "abyssal_clay",
        "name": "Abyssal Clay",
        "category": "earth_and_minerals",
        "category_name": "Earth & Minerals",
        "icon_url": "https://potservers.net/static/map-icons/earth-and-minerals/abyssal-clay.png?v=8e99d9520c3b",
        "count": 17,
        "points": [
          [444.41, 213.01],
          [456.3, 137.67],
          ... 15 more
        ],
        "world_points": [
          [200355, -38124, -22185],
          [212612, -115767, -22407],
          ... 15 more
        ]
      },
      {
        "id": "acorn",
        "name": "Acorn",
        "category": "nuts_and_seeds",
        "category_name": "Nuts & Seeds",
        "icon_url": "https://potservers.net/static/map-icons/nuts-and-seeds/acorn.png?v=151a0f4d2e27",
        "count": 10,
        "points": [
          [105.16, 436.86],
          [105.57, 437.23],
          ... 8 more
        ],
        "world_points": [
          [-149270, 192578, 8585],
          [-148850, 192962, 8584],
          ... 8 more
        ]
      },
      ... 118 more
    ],
    "regions": [
      {
        "id": "abyssal_depths",
        "name": "Abyssal Depths",
        "center": [460.22, 27.4],
        "world_center": [216656, -229416],
        "polygon": [
          [494.18, 177.89],
          [492.79, 182.44],
          ... 29 more
        ],
        "world_polygon": [
          [251652, -74314],
          [250221, -69627],
          ... 29 more
        ],
        "page_url": "https://potservers.net/map?map=Riparia&x=460.2&y=27.4&z=3.00"
      },
      {
        "id": "big_tree_overlook",
        "name": "Big Tree Overlook",
        "center": [231.06, 193.19],
        "world_center": [-19517, -58545],
        "polygon": [
          [270.93, 171.53],
          [292.35, 182.73],
          ... 31 more
        ],
        "world_polygon": [
          [21566, -80875],
          [43641, -69330],
          ... 31 more
        ],
        "page_url": "https://potservers.net/map?map=Riparia&x=231.1&y=193.2&z=3.00"
      },
      ... 20 more
    ],
    "landmarks": [
      {
        "id": "aperture_pass",
        "name": "Aperture Pass",
        "position": [117.53, 101.27],
        "world_position": [-136519, -153277, -8815],
        "radius": 5.78,
        "world_radius": 5959,
        "page_url": "https://potservers.net/map?map=Riparia&x=117.5&y=101.3&z=4.00"
      },
      {
        "id": "azure_crater",
        "name": "Azure Crater",
        "position": [147.7, 200.68],
        "world_position": [-105430, -50827, -16700],
        "radius": 9.27,
        "world_radius": 9556,
        "page_url": "https://potservers.net/map?map=Riparia&x=147.7&y=200.7&z=4.00"
      },
      ... 61 more
    ],
    "flight_paths": [
      {
        "type": "flight_path",
        "name": "Flight Path",
        "start": [19.11, 478.17],
        "world_start": [-237950, 235148, 9273],
        "route": [
          [19.11, 478.17],
          [27.46, 474.45],
          ... 11 more
        ],
        "world_route": [
          [-237950, 235148, 9273],
          [-229350, 231322, 8951],
          ... 11 more
        ]
      },
      {
        "type": "flight_path",
        "name": "Flight Path",
        "start": [76.93, 45.61],
        "world_start": [-178361, -210643, 4672],
        "route": [
          [76.93, 45.61],
          [77.02, 47.72],
          ... 17 more
        ],
        "world_route": [
          [-178361, -210643, 4672],
          [-178275, -208470, 5184],
          ... 17 more
        ]
      },
      ... 17 more
    ]
  },
  "meta": {
    "updated_at": "2026-10-18T19:31:19Z",
    "attribution": "Data from Potservers (https://potservers.net). Unofficial; Path of Titans belongs to Alderon Games."
  }
}

Response fields

Map

Field	Type	Description
`id`	string	Map id. One of `gondwa`, `panjura`, `riparia`.
`name`	string	Name.
`url`	URL	This map in the API.
`page_url`	URL	This map on potservers.net.
`updated_at`	date-time	When the map data last changed.
`coordinates`	MapCoordinates
`images`	list of MapImage	The map image in several sizes.
`markers`	list of MarkerKind	Every item on the map, grouped by type.
`regions`	list of Region	Named areas.
`landmarks`	list of Landmark	Landmarks players can discover.
`flight_paths`	list of FlightPath	Flight routes for flyers.

MapCoordinatesThe two ways positions are given. Map units run from 0 to 500 across the map image, from its top left, for drawing on the images. The world_* fields give the same positions as the game does, in centimetres with height. world_bounds is where the image edges sit in the game.

Field	Type	Description
`size`	integer	Map units run from 0 to this across the image.
`origin`	string	Where map position [0, 0] is. One of `top_left`.
`world_unit`	string	Unit of the world_* fields and world_bounds: centimetres, as the game measures. One of `cm`.
`world_bounds`	WorldBounds or null
`meters_per_unit`	number or null	Metres in one map unit along x. Some maps are not square, so use meters_per_unit_y for the y axis.
`meters_per_unit_y`	number or null	Metres in one map unit along y. It matches meters_per_unit on a square map and differs slightly on others, such as Gondwa.

WorldBoundsThe game x and y at the edges of the map image. A few world positions lie just past them; their map units stop at 0 or 500.

Field	Type	Description
`min_x`	number	Game x at map x 0.
`min_y`	number	Game y at map y 0.
`max_x`	number	Game x at map x 500.
`max_y`	number	Game y at map y 500.

MapImage

Field	Type	Description
`size`	integer	Width and height in pixels.
`format`	string	Image format. One of `jpeg`, `avif`, `webp`.
`url`	URL	Where to get it.

MarkerKind

Field	Type	Description
`id`	string	Item type id.
`name`	string	Name, as on the map page.
`category`	string	Category id.
`category_name`	string	Category name.
`icon_url`	URL or null	Icon (PNG), where there is one.
`count`	integer	How many there are.
`points`	list of [x, y]	Where each one is.
`world_points`	list of [x, y, z] or null	The same points as game positions, in the same order.

Region

Field	Type	Description
`id`	string	Region id.
`name`	string	Name.
`center`	[x, y]	A good spot for a label, inside the area.
`world_center`	[x, y] or null	The label spot as a game position, [x, y].
`polygon`	list of [x, y]	The outline.
`world_polygon`	list of [x, y] or null	The outline as game positions, [x, y] each, in the same order.
`page_url`	URL	The map centred on this area.

Landmark

Field	Type	Description
`id`	string	Landmark id.
`name`	string	Name.
`position`	[x, y]	Where it is.
`world_position`	[x, y, z] or null	Where it is, as a game position.
`radius`	number	How close players must get to discover it, in map units.
`world_radius`	number or null	The same radius in centimetres.
`page_url`	URL	The map centred on this landmark.

FlightPath

Field	Type	Description
`type`	string	Flight path or flight expedition. One of `flight_path`, `flight_expedition`.
`name`	string	Name.
`start`	[x, y]	Where it starts.
`world_start`	[x, y, z] or null	Where it starts, as a game position.
`route`	list of [x, y]	The route, in order.
`world_route`	list of [x, y, z] or null	The route as game positions, in the same order.

PointA position as [x, y] in map units: 0 to 500 across the map image, counted from the top left.

A JSON array of two numbers, [x, y], in map units. See Coordinates.

WorldPointA game position as [x, y, z] in centimetres, the units the game uses (what /mapbug prints). z is the height; it is left out where unknown.

A JSON array of numbers, [x, y, z], in game centimetres, with z left out where the height is unknown. See Coordinates.

WorldPoint2DA flat game position as [x, y] in centimetres, with no height. Region centres and outlines use this.

A JSON array of two numbers, [x, y], in game centimetres. See Coordinates.

Using map coordinates

Every position comes two ways.

Map units. points, polygon, position and the other plain fields are [x, y] on a 0 to 500 grid, starting at the map image's top left. Multiply by image size / 500 for pixels. They are also the x and y of links to the map page.

Game positions. Each has a world_ twin (world_points, world_polygon, world_position, world_radius and so on) in centimetres, as the game measures: the numbers /mapbug prints. Points are [x, y, z] with the height; region outlines and centres are [x, y]. world_bounds is where the image edges sit in the game.

Which to trust. The world_ values are the precise positions. The 0 to 500 map units are rounded to 0.01, which can put them up to about 10 cm off the game position, so convert from world_ when you need accuracy.

Scale. meters_per_unit is the size of one map unit along x and meters_per_unit_y is the same along y. Most maps are square, so the two match. Gondwa is slightly taller than it is wide, so they differ a little there.

Map images

Each map's images list links to its pictures, so you can copy those URLs as they are. They point at /api/v1/maps/{map}/image, which takes two optional query parameters: size (pixels, square) and format (jpeg, avif or webp). Only these combinations exist:

Format	Sizes
`jpeg`	`400`, `800`, `1024`, `2048`
`avif`	`2048`, `4096`
`webp`	`4096`

Leave both out for a 2048 px JPEG. Any other pair returns a 400 with invalid_parameter and a list of what is available.

Quests

Available quests, their tasks and the map items needed to complete them.

GETGet the quest list/api/v1/quests

Every quest players can get, sorted by name.

ReturnsA list of QuestSummary in data.

Request

curl --compressed https://potservers.net/api/v1/quests

Example response, trimmed

{
  "data": [
    {
      "id": "blueprints_quests_riparia_both_any_bp_quest_riparia_abyssal_depths",
      "name": "Abyssal Depths",
      "url": "https://potservers.net/api/v1/quests/blueprints_quests_riparia_both_any_bp_quest_riparia_abyssal_depths",
      "type": "exploration",
      "map": "riparia"
    },
    {
      "id": "blueprints_quests_riparia_group_meet_bp_quest_group_meet_abyssal_depths",
      "name": "Abyssal Depths",
      "url": "https://potservers.net/api/v1/quests/blueprints_quests_riparia_group_meet_bp_quest_group_meet_abyssal_depths",
      "type": "group_meet",
      "map": "riparia"
    },
    ... 1287 more
  ],
  "meta": {
    "count": 1289,
    "updated_at": "2026-10-18T19:26:26Z",
    "attribution": "Data from Potservers (https://potservers.net). Unofficial; Path of Titans belongs to Alderon Games."
  }
}

GETGet a quest/api/v1/quests/{id}

Everything about one quest: where it is, its tasks and their items.

Parameter	Type	Description
`id`path	string	Quest id, from the quest list.

ReturnsOne Quest in data.

Request

curl --compressed https://potservers.net/api/v1/quests/blueprints_quests_riparia_both_any_bp_quest_riparia_kelp_vale

Example response, trimmed

{
  "data": {
    "id": "blueprints_quests_riparia_both_any_bp_quest_riparia_kelp_vale",
    "name": "Kelp Vale",
    "url": "https://potservers.net/api/v1/quests/blueprints_quests_riparia_both_any_bp_quest_riparia_kelp_vale",
    "description": null,
    "type": "exploration",
    "map": "riparia",
    "location": {
      "name": "Kelp Vale",
      "region_id": "kelp_vale"
    },
    "share": "personal",
    "mod": null,
    "enabled": true,
    "tutorial": false,
    "tasks": [
      {
        "type": "explore",
        "name": "Kelp Vale",
        "description": null,
        "count": null,
        "items": [
          {
            "id": "kelp_vale",
            "name": "Kelp Vale",
            "count": null,
            "diet": null,
            "marker_kinds": []
          }
        ]
      }
    ]
  },
  "meta": {
    "updated_at": "2026-10-18T19:26:26Z",
    "attribution": "Data from Potservers (https://potservers.net). Unofficial; Path of Titans belongs to Alderon Games."
  }
}

Response fields

QuestSummary

Field	Type	Description
`id`	string	Quest id.
`name`	string	Name.
`url`	URL	Its full data in the API.
`type`	string	Quest type, such as gathering or hunting.
`map`	string or null	Map id, or null when it can come up on any map.

Quest

Field	Type	Description
`id`	string	Quest id.
`name`	string	Name.
`url`	URL	This quest in the API.
`description`	string or null	The game's description.
`type`	string	Quest type, such as gathering or hunting.
`map`	string or null	Map id, or null when it can come up on any map.
`location`	QuestPlace or null
`share`	string or null	How it is shared between players. One of `personal`, `group`, `local_world`, `survival`.
`mod`	string or null	The mod that adds it, if any.
`enabled`	boolean	Turned on in the game.
`tutorial`	boolean	A tutorial quest.
`tasks`	list of QuestTask	What it asks for.

QuestPlace

Field	Type	Description
`name`	string	The place, as the game names it.
`region_id`	string or null	The matching region in the map data, when there is one.

QuestTask

Field	Type	Description
`type`	string	Task type, such as gather, deliver or explore.
`name`	string or null	Name.
`description`	string or null	The game's description.
`count`	number or null	How many it needs.
`items`	list of QuestItem	Items that count toward it.

QuestItem

Field	Type	Description
`id`	string	Item id.
`name`	string	Name.
`count`	number or null	How many.
`diet`	string or null	Set when the item depends on what the player eats. One of `carnivore`, `herbivore`, `omnivore`.
`marker_kinds`	list of string	Map item types it comes from on the quest's map, matching marker ids in that map's data.

Usage notes

Requests	Use `GET`. No authentication needed. The only query parameters are `size` and `format` on map images.
Caching	Cache responses for five minutes to stay within the rate limit.
Websites	Call the API from your browser and embed the returned icon and map image URLs.
Errors	Check the HTTP status. Failed requests return `error` and `message`.
Updates	Version 1 may add fields. Existing fields keep their names and meaning.

Response fields

Field	Type	Description
`count`optional	integer	How many items the list has.
`updated_at`optional	date-time	When this data last changed.
`attribution`	string	A ready-made credit line. Any wording that names Potservers and links to potservers.net works.

Field	Type	Description
`error`	string	Short error code. One of `not_found`, `method_not_allowed`, `rate_limited`, `data_unavailable`, `invalid_parameter`.
`message`	string	What went wrong, in plain words.

Credit and terms

Free for personal and commercial projects. Wherever you show the data, credit Potservers with a link. Any wording works:

Data from <a href="https://potservers.net">Potservers</a>

Unofficial, not affiliated with Alderon Games. Game data belongs to Alderon Games; mod data belongs to its authors. Questions? Contact Hawk (bqj).