NHL operator_player_lookups API
operator_player_lookups
nhl.operator_player_lookupsHow each sportsbook and fantasy operator names every NHL player — the mapping from each operator's player identifier to a unified player record.
GET/api/v1/nhl/operator_player_lookupsList operator_player_lookups for NHL
Requires one of:
operator_id — requests satisfying none of these return 400.Parameters
operator_idquerybigintoptionalFilter by operator.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/nhl/operator_player_lookups?operator_id=1'Responses
200operator_player_lookups rows matching the declared filter set, wrapped in { operator_player_lookups, limit, next_from_id, has_more }. has_more is true when another row follows this page. To walk every row, start with ?from_id=0 and pass each next_from_id back as from_id until it is null; the filters stay. A first page without from_id comes in the default order and gives next_from_id null.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.
application/jsonResponse Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_player_id | string | — | External player ID from operator e.g. 8478042 |
player_id | bigintnullable | Internal nhl.players.id reference e.g. 404 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. 2026-08-19T22:09:48.576Z |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. Values:6740 "C. Schneider" is …7321 "C. Fitzgerald", n…Same human as DK 269241…6585 "R. Carpenter" is …Same human as DK 136307…Mirror names this id Co…7153 "M. Phillips" is a…Mirror names this id Ma…Mirror names this id Ca…Mirror names this id Da…Mirror names this id Du…Same human as DK 651123…Same human as DK 920505…Same human as DK 105722…Same human as DK 920402…Same human as DK 894729…Same human as DK 554479…Mirror names this id Ro…7049 "G. Smith" (C, nhl…6912 "G. Smith" (RW, nh… |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. Values:derivedpinnedblocked |
player_name | stringnullable | — | Player name for reconciliation e.g. Alex Tuch |
position | stringnullable | — | Position for reconciliation Values:DCWGRWLW |
GET/api/v1/nhl/operator_player_lookups/{id}Get a single operator_player_lookup by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_player_lookup row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/nhl/operator_player_lookups/{pk_value}'Responses
200Single operator_player_lookup row.application/jsonshow example ▸
404Row not found.
Response Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 1 | |
operator_player_id | string | — | External player ID from operator e.g. 8478042 |
player_id | bigintnullable | Internal nhl.players.id reference e.g. 404 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. 2026-08-19T22:09:48.576Z |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. Values:6740 "C. Schneider" is …7321 "C. Fitzgerald", n…Same human as DK 269241…6585 "R. Carpenter" is …Same human as DK 136307…Mirror names this id Co…7153 "M. Phillips" is a…Mirror names this id Ma…Mirror names this id Ca…Mirror names this id Da…Mirror names this id Du…Same human as DK 651123…Same human as DK 920505…Same human as DK 105722…Same human as DK 920402…Same human as DK 894729…Same human as DK 554479…Mirror names this id Ro…7049 "G. Smith" (C, nhl…6912 "G. Smith" (RW, nh… |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. Values:derivedpinnedblocked |
player_name | stringnullable | — | Player name for reconciliation e.g. Alex Tuch |
position | stringnullable | — | Position for reconciliation Values:DCWGRWLW |