---
title: "ML prediction history for a player (Pro Insights+)"
method: GET
path: "/v1/model/predictions/{playerId}"
tags: ["Intelligence"]
---

# ML prediction history for a player (Pro Insights+)

`GET /v1/model/predictions/{playerId}`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/model/predictions/{playerId}`
- Auth: API key in header `X-PlayCaller-Key`

Returns per-week NFL confidence model predictions for a player, including resolved outcomes (actual fantasy points vs. positional median) and rolling hit rate. Useful for validating our model's accuracy on specific players and building ML training pipelines.

**Tier access:** Pro Insights, Syndicate Alpha

## Path parameters

- `playerId` string, required

## Query parameters

- `limit` integer
- `season` integer
- `model_type` string

## Response `200`

ML prediction history

- object
  - `success` boolean
  - `player_id` string
  - `count` integer
  - `resolved_count` integer
  - `hit_rate` number, nullable: Fraction of resolved predictions that were correct (null if <1 resolved)
  - `predictions` object[]
    - `id` integer
    - `model_type` string
    - `predicted_score` number
    - `nfl_week` integer, nullable
    - `nfl_season` integer, nullable
    - `predicted_at` string, date-time
    - `outcome_recorded` boolean
    - `actual_points` number, nullable
    - `position_median` number, nullable
    - `hit` boolean, nullable

## Other responses

- `401`: Missing or invalid API key
- `402`: Pro Insights tier or higher required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)