---
title: "All Games API"
method: GET
path: "/v3/games"
---

# All Games API

`GET /v3/games`

Gamezop's All Games API allows you to access data on our games so you can list them in your own UI.

## Query parameters

- `lang` string

## Response `200`

You get an HTTP 200 when the API responds successfully with the list of games enabled for your Property ID.

- GamesListResponse
  - `data` Game[]
    - `code` string — Unique alphanumeric identifier for the game Example: `Ey5Wzu1MZ9l`
    - `url` string, uri — The URL to the game that you can embed in your app or website
    - `name` string — If you request data for any specific language, this field will contain the name of the game in that language. If we do not have the game name in the requested language, the English name of the game will be returned.
    - `description` string — Same like `name`, if we do not have the game description in the requested language, the English description of the game will be returned.
    - `screen_orientation` 'portrait' | 'landscape' | 'responsive' — Indicates the preferred screen orientation for the game
    - `has_integrated_ads` boolean — Integrated ads are opt-in ads built into a game's UI — for instance, a button to watch an ad for an extra life. They are different from the preroll / midroll interstitial ads that come before or during gameplay. In most games with integrated ads, the related UI elements are shown conditionally: if ads are disabled for your Property, the elements never appear. Such games return `false`. In some games, however, these UI elements are too core to the gameplay to be shown conditionally — they are always present, even when ads are disabled. Only such games return `true`. If you are working with us on a model where you have ads disabled, you should avoid using games where this value is `true`.
    - `category` Category
      - `id` 1 | 2 | 3 | 4 | 5 | 7 — Category identifier for the game. Possible values: 1 = Arcade 2 = Action 3 = Sports & Racing 4 = Strategy 5 = Puzzle & Logic 7 = Adventure.
      - `name` string — If you request data for any specific language, category.name will contain the game's category in that language. If we do not have the category name in the requested language, the English name for the game category will be returned.
    - `images` GameImages — To find more assets for any particular game, enter the code from the API for that game in our [Creatives Library's](https://gzp.gg/creatives) search bar.
      - `cover` string, uri — URL to a 600x492 pixel image asset.
      - `brick` string, uri — URL to a 310x150 pixel image asset.
      - `wall` string, uri — URL to a 1024x500 pixel image asset.
      - `thumb` string, uri — URL to a 512x512 pixel image asset with rounded corners and a Gamezop logo.
      - `square` string, uri — URL to a 512x512 pixel image asset without rounded corners and without a Gamezop logo.
      - `screenshots` string[] — Array of 3 URLs containing screenshots from the game.
      - `tall` string, uri — URL to a 450x800 pixel vertical image asset.
  - `success` boolean

## Other responses

- `401` — Unauthorized. You get a 401 when the Bearer token is missing, invalid, or belongs to an archived Property.

---

[API](https://skmtc.net/gamezop/apis/astrozop-apis.md) · [All operations](https://skmtc.net/gamezop/apis/astrozop-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gamezop/astrozop-apis/versions/485db86a5145/schema)