Resource

Weapon Types

The weapon classes available to characters. Each type lists its characters and weapons.

5items
1filters
2sort fields

Endpoints

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

List

Returns a paginated list of weapon 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/weapon-types?limit=2
{
  "count": 5,
  "next": "https://cdn.genshin-api.com/api/v1/weapon-types?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "sword",
      "name": "Sword",
      "url": "https://cdn.genshin-api.com/api/v1/weapon-types/sword",
      "icon": "https://cdn.genshin-api.com/weapon-types/sword.webp"
    },
    {
      "id": 2,
      "slug": "claymore",
      "name": "Claymore",
      "url": "https://cdn.genshin-api.com/api/v1/weapon-types/claymore",
      "icon": "https://cdn.genshin-api.com/weapon-types/claymore.webp"
    }
  ]
}

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
imagesobject
charactersReference[]
weaponsReference[]
GET /api/v1/weapon-types/polearm
{
  "id": 3,
  "slug": "polearm",
  "name": "Polearm",
  "url": "https://cdn.genshin-api.com/api/v1/weapon-types/polearm",
  "images": {
    "icon": "https://cdn.genshin-api.com/weapon-types/polearm.webp"
  },
  "characters": [
    {
      "id": 8,
      "slug": "xiangling",
      "name": "Xiangling",
      "url": "https://cdn.genshin-api.com/api/v1/characters/xiangling",
      "icon": "https://cdn.genshin-api.com/characters/xiangling/icon.png"
    },
    {
      "id": 27,
      "slug": "zhongli",
      "name": "Zhongli",
      "url": "https://cdn.genshin-api.com/api/v1/characters/zhongli",
      "icon": "https://cdn.genshin-api.com/characters/zhongli/icon.png"
    }
  ],
  "weapons": [
    {
      "id": 3,
      "slug": "beginners-protector",
      "name": "Beginner's Protector",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/beginners-protector",
      "icon": "https://cdn.genshin-api.com/weapons/beginners-protector/icon.webp"
    },
    {
      "id": 8,
      "slug": "iron-point",
      "name": "Iron Point",
      "url": "https://cdn.genshin-api.com/api/v1/weapons/iron-point",
      "icon": "https://cdn.genshin-api.com/weapons/iron-point/icon.webp"
    }
  ]
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name.

Try it

GETcdn.genshin-api.com