Rarities
Star ratings from 1 to 5. Each rarity lists the characters and weapons that have it.
5items
1filters
2sort fields
Endpoints
GET
/api/v1/raritiesPaginated listGET
/api/v1/rarities/randomRandom itemGET
/api/v1/rarities/{id or name}Single itemList
Returns a paginated list of rarities 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://cdn.genshin-api.com/api/v1/rarities?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "1-star",
"name": "1-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/1-star",
"stars": 1,
"icon": "https://cdn.genshin-api.com/rarities/1-star.webp"
},
{
"id": 2,
"slug": "2-star",
"name": "2-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/2-star",
"stars": 2,
"icon": "https://cdn.genshin-api.com/rarities/2-star.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 |
stars | number |
images | object |
characters | Reference[] |
weapons | Reference[] |
{
"id": 5,
"slug": "5-star",
"name": "5-Star",
"url": "https://cdn.genshin-api.com/api/v1/rarities/5-star",
"stars": 5,
"images": {
"icon": "https://cdn.genshin-api.com/rarities/5-star.webp"
},
"characters": [
{
"id": 1,
"slug": "aether",
"name": "Aether",
"url": "https://cdn.genshin-api.com/api/v1/characters/aether",
"icon": "https://cdn.genshin-api.com/characters/aether/icon.webp"
},
{
"id": 2,
"slug": "lumine",
"name": "Lumine",
"url": "https://cdn.genshin-api.com/api/v1/characters/lumine",
"icon": "https://cdn.genshin-api.com/characters/lumine/icon.webp"
}
],
"weapons": [
{
"id": 117,
"slug": "summit-shaper",
"name": "Summit Shaper",
"url": "https://cdn.genshin-api.com/api/v1/weapons/summit-shaper",
"icon": "https://cdn.genshin-api.com/weapons/summit-shaper/icon.webp"
},
{
"id": 118,
"slug": "skyward-blade",
"name": "Skyward Blade",
"url": "https://cdn.genshin-api.com/api/v1/weapons/skyward-blade",
"icon": "https://cdn.genshin-api.com/weapons/skyward-blade/icon.webp"
}
]
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name.