> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAPI Specifications

## Current specifications

Direct links to the live OpenAPI specification files, organized by product and version.

### Retail Media

| Version          | URL                                                                                                          |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| 2026-07 (stable) | [open-api-specifications.json](https://api.criteo.com/2026-07/retailmedia/open-api-specifications.json)      |
| 2026-01          | [open-api-specifications.json](https://api.criteo.com/2026-01/retailmedia/open-api-specifications.json)      |
| Preview          | [open-api-specifications.json](https://api.criteo.com/preview/retailmedia/open-api-specifications.json)      |
| Experimental     | [open-api-specifications.json](https://api.criteo.com/experimental/retailmedia/open-api-specifications.json) |
| 2025-10          | [open-api-specifications.json](https://api.criteo.com/2025-10/retailmedia/open-api-specifications.json)      |
| 2025-07          | [open-api-specifications.json](https://api.criteo.com/2025-07/retailmedia/open-api-specifications.json)      |
| 2025-04          | [open-api-specifications.json](https://api.criteo.com/2025-04/retailmedia/open-api-specifications.json)      |
| 2025-01          | [open-api-specifications.json](https://api.criteo.com/2025-01/retailmedia/open-api-specifications.json)      |

### Marketing Solutions

| Version          | URL                                                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| 2026-07 (stable) | [open-api-specifications.json](https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json)      |
| 2026-01          | [open-api-specifications.json](https://api.criteo.com/2026-01/marketingsolutions/open-api-specifications.json)      |
| Preview          | [open-api-specifications.json](https://api.criteo.com/preview/marketingsolutions/open-api-specifications.json)      |
| Experimental     | [open-api-specifications.json](https://api.criteo.com/experimental/marketingsolutions/open-api-specifications.json) |
| 2025-10          | [open-api-specifications.json](https://api.criteo.com/2025-10/marketingsolutions/open-api-specifications.json)      |
| 2025-07          | [open-api-specifications.json](https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json)      |
| 2025-04          | [open-api-specifications.json](https://api.criteo.com/2025-04/marketingsolutions/open-api-specifications.json)      |
| 2025-01          | [open-api-specifications.json](https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json)      |

### Commerce Grid

| Version | URL                                                                                                      |
| ------- | -------------------------------------------------------------------------------------------------------- |
| 2026-01 | [open-api-specifications.json](https://api.criteo.com/2026-01/commercegrid/open-api-specifications.json) |

***

## URL pattern

All specification files follow the same URL structure:

```http URL theme={null}
https://api.criteo.com/{version}/{criteo-service}/open-api-specifications.json
```

where:

* `{version}`: Any stable version starting from `v2020-10` or higher (without the `v`), or `preview` / `experimental`.

* `{criteo-service}`:
  * **`marketingsolutions`** for Marketing Solutions endpoints
  * **`retailmedia`** for Retail Media endpoints
  * **`commercegrid`** for Commerce Grid endpoints