Resource

Enemies

Common enemies, elites and bosses with their type, family, group, region, damage elements, resistances, drops, release version and archive description.

369items
8filters
2sort fields

Endpoints

GET/api/v1/enemiesPaginated list
GET/api/v1/enemies/randomRandom item
GET/api/v1/enemies/{id or name}Single item

List

Returns a paginated list of enemies in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name. Prefix with - for descending.
namePartial match on the name
typeEnemy type slug, e.g. elite-enemies. Comma-separated values allowed.
familyEnemy family slug, e.g. hilichurls. Comma-separated values allowed.
groupEnemy group slug, e.g. samachurls. Comma-separated values allowed.
regionRegion slug (only bosses have a region). Comma-separated values allowed.
elementDamage element slug, e.g. cryo. Comma-separated values allowed.
dropItem or artifact set slug the enemy drops, e.g. damaged-mask. Comma-separated values allowed.
releaseVersionRelease version, e.g. 5.0 or luna-i. Comma-separated values allowed.
GET /api/v1/enemies?limit=2
{
  "count": 369,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/enemies?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "anemo-slime",
      "name": "Anemo Slime",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/anemo-slime",
      "type": {
        "id": 1,
        "slug": "common-enemies",
        "name": "Common Enemies",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-types/common-enemies"
      },
      "family": {
        "id": 1,
        "slug": "elemental-lifeforms",
        "name": "Elemental Lifeforms",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/elemental-lifeforms"
      },
      "group": {
        "id": 1,
        "slug": "slimes",
        "name": "Slimes",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-groups/slimes"
      },
      "icon": null
    },
    {
      "id": 2,
      "slug": "cryo-slime",
      "name": "Cryo Slime",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/cryo-slime",
      "type": {
        "id": 1,
        "slug": "common-enemies",
        "name": "Common Enemies",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-types/common-enemies"
      },
      "family": {
        "id": 1,
        "slug": "elemental-lifeforms",
        "name": "Elemental Lifeforms",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/elemental-lifeforms"
      },
      "group": {
        "id": 1,
        "slug": "slimes",
        "name": "Slimes",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-groups/slimes"
      },
      "icon": null
    }
  ]
}

Single item

Returns the full details of one item, by numeric id or by name. Arrays in the example below are shortened.

Fields

FieldType
idnumber
slugstring
namestring
urlstring
typeReference
familyReference
groupReference | null
regionReference | null
elementsReference[]
releaseVersionReference | null
resistancesobject[]
dropsobject
domainsReference[]
descriptionstring | null
imagesobject
GET /api/v1/enemies/ruin-guard
{
  "id": 61,
  "slug": "ruin-guard",
  "name": "Ruin Guard",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/ruin-guard",
  "type": {
    "id": 2,
    "slug": "elite-enemies",
    "name": "Elite Enemies",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-types/elite-enemies"
  },
  "family": {
    "id": 5,
    "slug": "automatons",
    "name": "Automatons",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-families/automatons"
  },
  "group": {
    "id": 15,
    "slug": "humanoid-ruin-machines",
    "name": "Humanoid Ruin Machines",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemy-groups/humanoid-ruin-machines"
  },
  "region": null,
  "elements": [
    {
      "id": 8,
      "slug": "physical",
      "name": "Physical",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/elements/physical",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/elements/physical.svg"
    }
  ],
  "releaseVersion": {
    "id": 1,
    "slug": "1-0",
    "name": "1.0",
    "url": "https://genshin-api.replace_me.workers.dev/api/v1/versions/1-0"
  },
  "resistances": [
    {
      "stat": {
        "id": 21,
        "slug": "physical-res",
        "name": "Physical RES",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/physical-res"
      },
      "value": 70,
      "immune": false
    },
    {
      "stat": {
        "id": 27,
        "slug": "pyro-res",
        "name": "Pyro RES",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/pyro-res"
      },
      "value": 10,
      "immune": false
    }
  ],
  "drops": {
    "items": [
      {
        "id": 28,
        "slug": "chaos-device",
        "name": "Chaos Device",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/chaos-device"
      },
      {
        "id": 29,
        "slug": "chaos-circuit",
        "name": "Chaos Circuit",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/chaos-circuit"
      }
    ],
    "artifactSets": []
  },
  "domains": [],
  "description": "An ancient humanoid war machine.\nLegend has it that these machines were combat automatons created by a long-destroyed nation. They now wander ruins and ancient detritus, attacking offending travelers. Research indicates that the Ruin Guards and the ruins they operate in do not originate from the same source, suggesting that there may be a difference of as much as several thousand years between them on the timeline. So why then do the Ruin Guards continue staying among these ruins, using their \"explosive firepower\" to protect the crumbling walls and broken tiles?",
  "images": {}
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.

Try it

GETgenshin-api.REPLACE_ME.workers.dev