---
title: "Read fair-value history for one outcome"
method: GET
path: "/v1/fair-values/{outcomeId}/history"
tags: ["Fair Values"]
---

# Read fair-value history for one outcome

`GET /v1/fair-values/{outcomeId}/history`

## Request

- Base URL: `https://sorqen.flashodds.live`
- URL: `https://sorqen.flashodds.live/v1/fair-values/{outcomeId}/history`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

History is plan-gated. Free keys authenticate successfully but receive plan_required; Builder and above receive a plan-bounded window.

## Path parameters

- `outcomeId` string, required

## Query parameters

- `days` integer

## Response `200`

Historical fair-value series.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The authenticated plan does not include this entitlement.
- `404`: No history in the requested window.
- `429`: Plan request limit exceeded. Retry-After and X-RateLimit headers are returned.

---

[API](https://skmtc.dev/flashodds/apis/sorqen-api.md) · [All operations](https://skmtc.dev/flashodds/apis/sorqen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flashodds/apis/sorqen-api/revisions/ec67a9e22813?raw)