STAT-API

NHL operator_player_lookups API

operator_player_lookupsnhl.operator_player_lookups
How 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_lookups
Requires one of: operator_id — requests satisfying none of these return 400.
Parameters
operator_idquerybigintoptional
Filter by operator.
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(9 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintnullableInternal 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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
operator_id
bigintOperator 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
bigintnullableInternal 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