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 listGET
/api/v1/weapon-types/randomRandom itemGET
/api/v1/weapon-types/{id or name}Single itemList
Returns a paginated list of weapon 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": 5,
"next": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "sword",
"name": "Sword",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/sword",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/sword.webp"
},
{
"id": 2,
"slug": "claymore",
"name": "Claymore",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/claymore",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/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
| Field | Type |
|---|---|
id | number |
slug | string |
name | string |
url | string |
images | object |
characters | Reference[] |
weapons | Reference[] |
{
"id": 3,
"slug": "polearm",
"name": "Polearm",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapon-types/polearm",
"images": {
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapon-types/polearm.webp"
},
"characters": [
{
"id": 8,
"slug": "xiangling",
"name": "Xiangling",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/xiangling",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/xiangling/icon.png"
},
{
"id": 27,
"slug": "zhongli",
"name": "Zhongli",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/zhongli",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/zhongli/icon.png"
}
],
"weapons": [
{
"id": 3,
"slug": "beginners-protector",
"name": "Beginner's Protector",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/beginners-protector",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/beginners-protector/icon.webp"
},
{
"id": 8,
"slug": "iron-point",
"name": "Iron Point",
"url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/iron-point",
"icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/iron-point/icon.webp"
}
]
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name.