---
title: "Future Mapping"
method: GET
path: "/futures/mapping"
tags: ["mapping"]
---

# Future Mapping

`GET /futures/mapping`

Map internal future IDs to bookmaker/provider future IDs.

Lookup mode: required `bookmaker` + (`futureIds` OR `bookmakerFutureIds`).

## Query parameters

- `bookmaker` string, required
- `futureIds` string, nullable
- `bookmakerFutureIds` string, nullable

## Response `200`

Returns FutureMapping[]

- FutureMapping[]
  - `bookmaker` string, required
  - `futureId` string, nullable
  - `bookmakerFutureId` string, nullable
  - `participantsRotated` boolean, required

## Other responses

- `400` — API error
- `401` — API error
- `403` — API error
- `422` — Validation Error (framework-level)
- `429` — API error

---

[API](https://skmtc.net/oddspapi/apis/odds-api-v5.md) · [All operations](https://skmtc.net/oddspapi/apis/odds-api-v5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oddspapi/odds-api-v5/revisions/5fe687d7c592/schema)