## 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) |
| Experimental     | [open-api-specifications.json](https://api.criteo.com/experimental/retailmedia/open-api-specifications.json) |
| 2026-01         | [open-api-specifications.json](https://api.criteo.com/2026-01/retailmedia/open-api-specifications.json) |
| Preview (legacy) | [open-api-specifications.json](https://api.criteo.com/preview/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) |
| Experimental     | [open-api-specifications.json](https://api.criteo.com/experimental/marketingsolutions/open-api-specifications.json) |
| 2026-01         | [open-api-specifications.json](https://api.criteo.com/2026-01/marketingsolutions/open-api-specifications.json) |
| Preview (legacy) | [open-api-specifications.json](https://api.criteo.com/preview/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:

```
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