---
title: "Line history for a prop (Builder+)"
method: GET
path: "/api/v1/props/history"
tags: ["Props"]
---

# Line history for a prop (Builder+)

`GET /api/v1/props/history`

## Request

- Base URL: `https://api.flashodds.live`
- URL: `https://api.flashodds.live/api/v1/props/history`
- Auth: HTTP bearer

Chronological line/odds history for a player prop, with opened/current/movement. Builder gets a short window (most recent points), Pro the full history; free is locked out. History accrues from when archiving started, so early results may be short.

## Query parameters

- `player` string, required: Player name (case-insensitive contains match). Required.
- `sport` string
- `stat` string
- `event` string: Restrict to one event id.
- `limit` integer

## Response `200`

Prop line history

- PropHistory
  - `found` boolean, required
  - `matchedProps` integer, required: Distinct props matched (the most-recently-active one is returned).
  - `sport` string
  - `eventId` string, nullable
  - `player` string
  - `playerId` string, nullable
  - `team` string, nullable
  - `stat` string
  - `startTime` string, nullable
  - `openedLine` number, nullable
  - `currentLine` number, nullable
  - `movement` number, nullable: currentLine - openedLine.
  - `lastChangedAt` number, nullable
  - `points` integer: Observations in the series.
  - `history` HistoryPoint[]
    - `capturedAt` number, required: Epoch ms when this line was observed.
    - `line` number, required
    - `overOdds` number, nullable
    - `underOdds` number, nullable
  - `gated` boolean, required: True when data was withheld for your tier.
  - `preview` boolean, required: True when this is a reduced/preview view.
  - `requiredTier` 'starter' | 'pro' | 'enterprise' | 'null', nullable, required: Lowest tier that unlocks the first locked field. Null when nothing is gated.
  - `lockedFields` string[], required: Dot-paths of the fields withheld for your tier.
  - `upgradeMessage` string, nullable, required: Human upgrade prompt, or null when nothing is gated.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: Not permitted on your tier
- `429`: Rate limit or daily quota exceeded

---

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