Resource

Stats

Character attributes such as HP, CRIT Rate or Elemental Mastery. Each stat lists the characters that gain it on ascension, the weapons that have it as secondary stat and the artifact types where it can roll.

33items
3filters
2sort fields

Endpoints

GET/api/v1/statsPaginated list
GET/api/v1/stats/randomRandom item
GET/api/v1/stats/{id or name}Single item

List

Returns a paginated list of stats 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
categorybasic | advanced | hidden. Comma-separated values allowed.
elementElement slug, for DMG Bonus and RES stats. Comma-separated values allowed.
GET /api/v1/stats?limit=2
{
  "count": 33,
  "next": "https://cdn.genshin-api.com/api/v1/stats?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "hp",
      "name": "HP",
      "url": "https://cdn.genshin-api.com/api/v1/stats/hp",
      "category": "basic",
      "element": null
    },
    {
      "id": 2,
      "slug": "atk",
      "name": "ATK",
      "url": "https://cdn.genshin-api.com/api/v1/stats/atk",
      "category": "basic",
      "element": 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
categorystring
elementReference | null
descriptionstring
imagesobject
charactersReference[]
weaponsReference[]
artifactsobject
GET /api/v1/stats/crit-rate
{
  "id": 6,
  "slug": "crit-rate",
  "name": "CRIT Rate",
  "url": "https://cdn.genshin-api.com/api/v1/stats/crit-rate",
  "category": "advanced",
  "element": null,
  "description": "Critical Rate is abbreviated in-game as CRIT Rate. This attribute, expressed as a percentage, determines how likely it is that an attack will hit critically and deal bonus critical damage.",
  "images": {},
  "characters": [
    {
      "id": 13,
      "slug": "diluc",
      "name": "Diluc",
      "url": "https://cdn.genshin-api.com/api/v1/characters/diluc",
      "icon": "https://cdn.genshin-api.com/characters/diluc/icon.png"
    },
    {
      "id": 30,
      "slug": "xiao",
      "name": "Xiao",
      "url": "https://cdn.genshin-api.com/api/v1/characters/xiao",
      "icon": "https://cdn.genshin-api.com/characters/xiao/icon.png"
    }
  ],
  "weapons": [
    {
      "id": 22,
      "slug": "white-tassel",
      "name": "White Tassel",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/white-tassel",
      "icon": "https://cdn.genshin-api.com/weapons/white-tassel/icon.webp"
    },
    {
      "id": 25,
      "slug": "twin-nephrite",
      "name": "Twin Nephrite",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/twin-nephrite",
      "icon": "https://cdn.genshin-api.com/weapons/twin-nephrite/icon.webp"
    }
  ],
  "artifacts": {
    "mainStat": [
      {
        "id": 5,
        "slug": "circlet-of-logos",
        "name": "Circlet of Logos",
        "url": "https://cdn.genshin-api.com/api/v1/artifact-types/circlet-of-logos"
      }
    ],
    "subStat": [
      {
        "id": 1,
        "slug": "flower-of-life",
        "name": "Flower of Life",
        "url": "https://cdn.genshin-api.com/api/v1/artifact-types/flower-of-life"
      },
      {
        "id": 2,
        "slug": "plume-of-death",
        "name": "Plume of Death",
        "url": "https://cdn.genshin-api.com/api/v1/artifact-types/plume-of-death"
      }
    ]
  }
}

Random

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

Try it

GETcdn.genshin-api.com