Item Types
Item types as shown in the in-game inventory, such as Character Ascension Materials or Local Specialties. Each type lists its groups and items.
6items
1filters
2sort fields
Endpoints
GET
/api/v1/item-typesPaginated listGET
/api/v1/item-types/randomRandom itemGET
/api/v1/item-types/{id or name}Single itemList
Returns a paginated list of item 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 |
{
"count": 6,
"next": "https://cdn.genshin-api.com/api/v1/item-types?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "character-and-weapon-enhancement-materials",
"name": "Character and Weapon Enhancement Materials",
"url": "https://cdn.genshin-api.com/api/v1/item-types/character-and-weapon-enhancement-materials",
"inventoryCategory": "Character Development Items",
"icon": null
},
{
"id": 2,
"slug": "character-ascension-materials",
"name": "Character Ascension Materials",
"url": "https://cdn.genshin-api.com/api/v1/item-types/character-ascension-materials",
"inventoryCategory": "Character Development Items",
"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 |
inventoryCategory | string |
images | object |
groups | Reference[] |
items | Reference[] |
{
"id": 3,
"slug": "character-level-up-materials",
"name": "Character Level-Up Materials",
"url": "https://cdn.genshin-api.com/api/v1/item-types/character-level-up-materials",
"inventoryCategory": "Character Development Items",
"images": {},
"groups": [
{
"id": 20,
"slug": "dvalin-materials",
"name": "Dvalin Materials",
"url": "https://cdn.genshin-api.com/api/v1/item-groups/dvalin-materials"
},
{
"id": 21,
"slug": "lupus-boreas-materials",
"name": "Lupus Boreas Materials",
"url": "https://cdn.genshin-api.com/api/v1/item-groups/lupus-boreas-materials"
}
],
"items": [
{
"id": 64,
"slug": "hurricane-seed",
"name": "Hurricane Seed",
"url": "https://cdn.genshin-api.com/api/v1/items/hurricane-seed"
},
{
"id": 65,
"slug": "lightning-prism",
"name": "Lightning Prism",
"url": "https://cdn.genshin-api.com/api/v1/items/lightning-prism"
}
]
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name.