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 listGET
/api/v1/artifact-types/randomRandom itemGET
/api/v1/artifact-types/{id or name}Single itemList
Returns a paginated list of artifact types in summary form.
Query parameters
| Parameter | Description |
|---|---|
limit | Items per page (1-100, default 20) |
offset | Items to skip (default 0) |
sort | One of id, name. Prefix with - for descending. |
name | Partial match on the name |
mainStat | Possible main stat slug, e.g. crit-rate. Comma-separated values allowed. |
{
"count": 5,
"next": "https://cdn.genshin-api.com/api/v1/artifact-types?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "flower-of-life",
"name": "Flower of Life",
"url": "https://cdn.genshin-api.com/api/v1/artifact-types/flower-of-life",
"icon": null
},
{
"id": 2,
"slug": "plume-of-death",
"name": "Plume of Death",
"url": "https://cdn.genshin-api.com/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
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
mainStats | object[] |
subStats | object[] |
images | object |
artifactSets | Reference[] |
{
"id": 1,
"slug": "flower-of-life",
"name": "Flower of Life",
"url": "https://cdn.genshin-api.com/api/v1/artifact-types/flower-of-life",
"mainStats": [
{
"stat": {
"id": 1,
"slug": "hp",
"name": "HP",
"url": "https://cdn.genshin-api.com/api/v1/stats/hp"
},
"percent": false
}
],
"subStats": [
{
"stat": {
"id": 1,
"slug": "hp",
"name": "HP",
"url": "https://cdn.genshin-api.com/api/v1/stats/hp"
},
"percent": false
},
{
"stat": {
"id": 2,
"slug": "atk",
"name": "ATK",
"url": "https://cdn.genshin-api.com/api/v1/stats/atk"
},
"percent": false
}
],
"images": {},
"artifactSets": [
{
"id": 1,
"slug": "initiate",
"name": "Initiate",
"url": "https://cdn.genshin-api.com/api/v1/artifact-sets/initiate"
},
{
"id": 2,
"slug": "adventurer",
"name": "Adventurer",
"url": "https://cdn.genshin-api.com/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.