Resource

Artifact Types

The five artifact slots with their possible main stats and sub stats. Each type lists the artifact sets that have a piece for it.

5items
2filters
2sort fields

Endpoints

GET/api/v1/artifact-typesPaginated list
GET/api/v1/artifact-types/randomRandom item
GET/api/v1/artifact-types/{id or name}Single item

List

Returns a paginated list of artifact types 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
mainStatPossible main stat slug, e.g. crit-rate. Comma-separated values allowed.
GET /api/v1/artifact-types?limit=2
{
  "count": 5,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-types?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "flower-of-life",
      "name": "Flower of Life",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-types/flower-of-life",
      "icon": null
    },
    {
      "id": 2,
      "slug": "plume-of-death",
      "name": "Plume of Death",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-types/plume-of-death",
      "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
mainStatsobject[]
subStatsobject[]
imagesobject
artifactSetsReference[]
GET /api/v1/artifact-types/flower-of-life
{
  "id": 1,
  "slug": "flower-of-life",
  "name": "Flower of Life",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-types/flower-of-life",
  "mainStats": [
    {
      "stat": {
        "id": 1,
        "slug": "hp",
        "name": "HP",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/hp"
      },
      "percent": false
    }
  ],
  "subStats": [
    {
      "stat": {
        "id": 1,
        "slug": "hp",
        "name": "HP",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/hp"
      },
      "percent": false
    },
    {
      "stat": {
        "id": 2,
        "slug": "atk",
        "name": "ATK",
        "url": "https://genshin-api.replace_me.workers.dev/api/v1/stats/atk"
      },
      "percent": false
    }
  ],
  "images": {},
  "artifactSets": [
    {
      "id": 1,
      "slug": "initiate",
      "name": "Initiate",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-sets/initiate"
    },
    {
      "id": 2,
      "slug": "adventurer",
      "name": "Adventurer",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/artifact-sets/adventurer"
    }
  ]
}

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