---
title: "Get game details"
method: POST
path: "/v2/marketplace/details"
tags: ["marketplace"]
---

# Get game details

`POST /v2/marketplace/details`

Returns detailed information for specified product IDs (comma-separated).

**Response Structure:**
- `content`: Product details from Microsoft's catalog API
- `code`: HTTP status code from upstream (200 = success, 400 = invalid IDs, 500 = upstream error)

## Finding the Xbox Title ID

Each product includes an `AlternateIds` array, and the Xbox title ID is the entry with
`IdType: "XboxTitleId"`:

```json
"AlternateIds": [
  { "IdType": "LegacyWindowsStoreProductId", "Value": "d9c4f2f1-b701-4456-881b-4a434dcc8c3a" },
  { "IdType": "XboxTitleId", "Value": "2083118773" },
  { "IdType": "LegacyXboxProductId", "Value": "33564e39-324c-3033-c034-564758442e00" }
]
```

That `Value` is what the achievements, stats and title history endpoints expect.

Responses are large (roughly 45 KB per product). For just the title ID, use
`GET /v2/marketplace/titleid/{productId}`, or
`GET /v2/marketplace/search?q=...&enrich=titleid` to resolve a whole result set at once.

**Not every product has one.** Add-ons, bundles and PC-only listings have no
`XboxTitleId` entry. Note also that a game and its demo are separate products with
*different* title IDs, and that some games have both a PC and an Xbox listing where only
the Xbox one carries a title ID.

## Request body

- object
  - `products` string, required

## Response `200`

Game details

- ApiResponse — Standard API response wrapper. All endpoints return responses in this format.
  - `content` unknown, required
  - `code` integer, required — HTTP status code from the upstream API. Common values: 200 (success), 400 (bad request), 401 (unauthorized), 404 (not found), 410 (deprecated/gone), 429 (rate limited), 500 (server error)

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/xbl/apis/openxbl-api.md) · [All operations](https://skmtc.dev/xbl/apis/openxbl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xbl/openxbl-api/revisions/e5df7bdca559/schema)