Versions
Game versions with their update title and release date. Each version lists the characters, weapons, constellations, artifact sets, enemies, items and domains released in it.
54items
1filters
3sort fields
Endpoints
GET
/api/v1/versionsPaginated listGET
/api/v1/versions/randomRandom itemGET
/api/v1/versions/{id or name}Single itemList
Returns a paginated list of versions 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, releaseDate. Prefix with - for descending. |
name | Partial match on the name |
{
"count": 54,
"next": "https://cdn.genshin-api.com/api/v1/versions?limit=2&offset=2",
"previous": null,
"results": [
{
"id": 1,
"slug": "1-0",
"name": "1.0",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-0",
"title": "Welcome to Teyvat",
"releaseDate": "2020-09-28"
},
{
"id": 2,
"slug": "1-1",
"name": "1.1",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-1",
"title": "A New Star Approaches",
"releaseDate": "2020-11-11"
}
]
}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 |
title | string |
releaseDate | string |
characters | Reference[] |
weapons | Reference[] |
artifactSets | Reference[] |
enemies | Reference[] |
items | Reference[] |
constellations | Reference[] |
domains | Reference[] |
{
"id": 4,
"slug": "1-3",
"name": "1.3",
"url": "https://cdn.genshin-api.com/api/v1/versions/1-3",
"title": "All That Glitters",
"releaseDate": "2021-02-03",
"characters": [
{
"id": 30,
"slug": "xiao",
"name": "Xiao",
"url": "https://cdn.genshin-api.com/api/v1/characters/xiao",
"icon": "https://cdn.genshin-api.com/characters/xiao/icon.png"
},
{
"id": 31,
"slug": "hu-tao",
"name": "Hu Tao",
"url": "https://cdn.genshin-api.com/api/v1/characters/hu-tao",
"icon": "https://cdn.genshin-api.com/characters/hu-tao/icon.png"
}
],
"weapons": [
{
"id": 63,
"slug": "lithic-blade",
"name": "Lithic Blade",
"url": "https://cdn.genshin-api.com/api/v1/weapons/lithic-blade",
"icon": "https://cdn.genshin-api.com/weapons/lithic-blade/icon.webp"
},
{
"id": 74,
"slug": "lithic-spear",
"name": "Lithic Spear",
"url": "https://cdn.genshin-api.com/api/v1/weapons/lithic-spear",
"icon": "https://cdn.genshin-api.com/weapons/lithic-spear/icon.webp"
}
],
"artifactSets": [],
"enemies": [
{
"id": 83,
"slug": "geovishap",
"name": "Geovishap",
"url": "https://cdn.genshin-api.com/api/v1/enemies/geovishap"
},
{
"id": 84,
"slug": "primo-geovishap",
"name": "Primo Geovishap",
"url": "https://cdn.genshin-api.com/api/v1/enemies/primo-geovishap"
}
],
"items": [
{
"id": 137,
"slug": "juvenile-jade",
"name": "Juvenile Jade",
"url": "https://cdn.genshin-api.com/api/v1/items/juvenile-jade"
}
],
"constellations": [
{
"id": 32,
"slug": "alatus-nemeseos",
"name": "Alatus Nemeseos",
"url": "https://cdn.genshin-api.com/api/v1/constellations/alatus-nemeseos"
},
{
"id": 33,
"slug": "papilio-charontis",
"name": "Papilio Charontis",
"url": "https://cdn.genshin-api.com/api/v1/constellations/papilio-charontis"
}
],
"domains": [
{
"id": 40,
"slug": "abyssal-traces",
"name": "Abyssal Traces",
"url": "https://cdn.genshin-api.com/api/v1/domains/abyssal-traces"
},
{
"id": 41,
"slug": "enter-the-border",
"name": "Enter the \"border\"",
"url": "https://cdn.genshin-api.com/api/v1/domains/enter-the-border"
}
]
}Random
Returns one random item with the same shape as the single item endpoint. Accepts name.