Resource

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

List

Returns a paginated list of versions in summary form.

Query parameters

ParameterDescription
limitItems per page (1-100, default 20)
offsetItems to skip (default 0)
sortOne of id, name, releaseDate. Prefix with - for descending.
namePartial match on the name
GET /api/v1/versions?limit=2
{
  "count": 54,
  "next": "https://genshin-api.replace_me.workers.dev/api/v1/versions?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "1-0",
      "name": "1.0",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/versions/1-0",
      "title": "Welcome to Teyvat",
      "releaseDate": "2020-09-28"
    },
    {
      "id": 2,
      "slug": "1-1",
      "name": "1.1",
      "url": "https://genshin-api.replace_me.workers.dev/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

FieldType
idnumber
slugstring
namestring
urlstring
titlestring
releaseDatestring
charactersReference[]
weaponsReference[]
artifactSetsReference[]
enemiesReference[]
itemsReference[]
constellationsReference[]
domainsReference[]
GET /api/v1/versions/1-3
{
  "id": 4,
  "slug": "1-3",
  "name": "1.3",
  "url": "https://genshin-api.replace_me.workers.dev/api/v1/versions/1-3",
  "title": "All That Glitters",
  "releaseDate": "2021-02-03",
  "characters": [
    {
      "id": 30,
      "slug": "xiao",
      "name": "Xiao",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/xiao",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/xiao/icon.png"
    },
    {
      "id": 31,
      "slug": "hu-tao",
      "name": "Hu Tao",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/characters/hu-tao",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/characters/hu-tao/icon.png"
    }
  ],
  "weapons": [
    {
      "id": 63,
      "slug": "lithic-blade",
      "name": "Lithic Blade",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/lithic-blade",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/lithic-blade/icon.webp"
    },
    {
      "id": 74,
      "slug": "lithic-spear",
      "name": "Lithic Spear",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/weapons/lithic-spear",
      "icon": "https://pub-ee487cafc1aa471a90a3f2ae46c5e85f.r2.dev/weapons/lithic-spear/icon.webp"
    }
  ],
  "artifactSets": [],
  "enemies": [
    {
      "id": 83,
      "slug": "geovishap",
      "name": "Geovishap",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/geovishap"
    },
    {
      "id": 84,
      "slug": "primo-geovishap",
      "name": "Primo Geovishap",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/enemies/primo-geovishap"
    }
  ],
  "items": [
    {
      "id": 137,
      "slug": "juvenile-jade",
      "name": "Juvenile Jade",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/items/juvenile-jade"
    }
  ],
  "constellations": [
    {
      "id": 32,
      "slug": "alatus-nemeseos",
      "name": "Alatus Nemeseos",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/constellations/alatus-nemeseos"
    },
    {
      "id": 33,
      "slug": "papilio-charontis",
      "name": "Papilio Charontis",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/constellations/papilio-charontis"
    }
  ],
  "domains": [
    {
      "id": 40,
      "slug": "abyssal-traces",
      "name": "Abyssal Traces",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/domains/abyssal-traces"
    },
    {
      "id": 41,
      "slug": "enter-the-border",
      "name": "Enter the \"border\"",
      "url": "https://genshin-api.replace_me.workers.dev/api/v1/domains/enter-the-border"
    }
  ]
}

Random

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

Try it

GETgenshin-api.REPLACE_ME.workers.dev