Resource

Domains

Challenge, trounce, one-time and quest domains with their type, location, recommended elements, difficulty tiers, rewards, bosses and release version. Domains of Forgery and Mastery list the material each level gives and the days it is open.

192items
6filters
2sort fields

Endpoints

GET/api/v1/domainsPaginated list
GET/api/v1/domains/randomRandom item
GET/api/v1/domains/{id or name}Single item

List

Returns a paginated list of domains 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
typeDomain type slug, e.g. domains-of-blessing. Comma-separated values allowed.
regionRegion slug. Comma-separated values allowed.
elementRecommended element slug, e.g. pyro. Comma-separated values allowed.
rewardItem or artifact set slug the domain rewards, e.g. teachings-of-freedom or crimson-witch-of-flames. Comma-separated values allowed.
releaseVersionRelease version, e.g. 1.0 or luna-i. Comma-separated values allowed.
GET /api/v1/domains?limit=2
{
  "count": 192,
  "next": "https://cdn.genshin-api.com/api/v1/domains?limit=2&offset=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "slug": "clear-pool-and-mountain-cavern",
      "name": "Clear Pool and Mountain Cavern",
      "url": "https://cdn.genshin-api.com/api/v1/domains/clear-pool-and-mountain-cavern",
      "type": {
        "id": 1,
        "slug": "domains-of-blessing",
        "name": "Domains of Blessing",
        "url": "https://cdn.genshin-api.com/api/v1/domain-types/domains-of-blessing"
      },
      "region": {
        "id": 2,
        "slug": "liyue",
        "name": "Liyue",
        "url": "https://cdn.genshin-api.com/api/v1/regions/liyue",
        "icon": "https://cdn.genshin-api.com/regions/liyue.webp"
      },
      "icon": null
    },
    {
      "id": 2,
      "slug": "domain-of-guyun",
      "name": "Domain of Guyun",
      "url": "https://cdn.genshin-api.com/api/v1/domains/domain-of-guyun",
      "type": {
        "id": 1,
        "slug": "domains-of-blessing",
        "name": "Domains of Blessing",
        "url": "https://cdn.genshin-api.com/api/v1/domain-types/domains-of-blessing"
      },
      "region": {
        "id": 2,
        "slug": "liyue",
        "name": "Liyue",
        "url": "https://cdn.genshin-api.com/api/v1/regions/liyue",
        "icon": "https://cdn.genshin-api.com/regions/liyue.webp"
      },
      "icon": null
    }
  ]
}

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
typeReference
regionReference | null
areastring | null
descriptionstring | null
recommendedElementsReference[]
tiersobject[]
levelsobject[]
rewardsobject
enemiesReference[]
releaseVersionReference | null
imagesobject
GET /api/v1/domains/cecilia-garden
{
  "id": 6,
  "slug": "cecilia-garden",
  "name": "Cecilia Garden",
  "url": "https://cdn.genshin-api.com/api/v1/domains/cecilia-garden",
  "type": {
    "id": 2,
    "slug": "domains-of-forgery",
    "name": "Domains of Forgery",
    "url": "https://cdn.genshin-api.com/api/v1/domain-types/domains-of-forgery"
  },
  "region": {
    "id": 1,
    "slug": "mondstadt",
    "name": "Mondstadt",
    "url": "https://cdn.genshin-api.com/api/v1/regions/mondstadt",
    "icon": "https://cdn.genshin-api.com/regions/mondstadt.webp"
  },
  "area": "Windwail Highland",
  "description": "The Cecilia flowers that only grow on high cliffs once bloomed in the greenhouses here. The ancient civilization that once enjoyed the scent of the Cecilia was lost, and so too was the sea of white flowers.",
  "recommendedElements": [
    {
      "id": 3,
      "slug": "electro",
      "name": "Electro",
      "url": "https://cdn.genshin-api.com/api/v1/elements/electro",
      "icon": "https://cdn.genshin-api.com/elements/electro.svg"
    }
  ],
  "tiers": [
    {
      "requiredAdventureRank": 15,
      "recommendedLevel": 15
    },
    {
      "requiredAdventureRank": 21,
      "recommendedLevel": 36
    }
  ],
  "levels": [
    {
      "name": "City of Reflections",
      "days": [
        "monday",
        "thursday"
      ],
      "group": {
        "id": 28,
        "slug": "decarabian-tiles",
        "name": "Decarabian Tiles",
        "url": "https://cdn.genshin-api.com/api/v1/item-groups/decarabian-tiles"
      }
    },
    {
      "name": "Submerged Valley",
      "days": [
        "tuesday",
        "friday"
      ],
      "group": {
        "id": 29,
        "slug": "boreal-wolf-teeth",
        "name": "Boreal Wolf Teeth",
        "url": "https://cdn.genshin-api.com/api/v1/item-groups/boreal-wolf-teeth"
      }
    }
  ],
  "rewards": {
    "items": [
      {
        "id": 94,
        "slug": "tile-of-decarabians-tower",
        "name": "Tile of Decarabian's Tower",
        "url": "https://cdn.genshin-api.com/api/v1/items/tile-of-decarabians-tower"
      },
      {
        "id": 95,
        "slug": "debris-of-decarabians-city",
        "name": "Debris of Decarabian's City",
        "url": "https://cdn.genshin-api.com/api/v1/items/debris-of-decarabians-city"
      }
    ],
    "artifactSets": []
  },
  "enemies": [],
  "releaseVersion": {
    "id": 1,
    "slug": "1-0",
    "name": "1.0",
    "url": "https://cdn.genshin-api.com/api/v1/versions/1-0"
  },
  "images": {}
}

Random

Returns one random item with the same shape as the single item endpoint. Accepts name and every list filter.

Try it

GETcdn.genshin-api.com