Resource

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 list
GET/api/v1/item-types/randomRandom item
GET/api/v1/item-types/{id or name}Single item

List

Returns a paginated list of item 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
GET /api/v1/item-types?limit=2
{
  "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

FieldType
idnumber
slugstring
namestring
urlstring
inventoryCategorystring
imagesobject
groupsReference[]
itemsReference[]
GET /api/v1/item-types/character-level-up-materials
{
  "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.

Try it

GETcdn.genshin-api.com