Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Free Agents

NHL Free Agents provides detailed player information for all current free agents in the league.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Updates in realtime as changes are made to rosters or player profiles


Data Points

League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NHL
idleagueGUIDUnique ID of a league

ex. fd560107-a85b-4388-ab0d-655ad022aff7
nameleagueStringName of a league

ex. NHL
Player
AttributeParent ElementTypeDescription
abbr_namefree_agentStringAbbreviated name of a player

ex. S.Crosby
birthdatefree_agentDatePlayer date of birth

ex. 1987-08-07
birth_placefree_agentStringBirthplace of a player

ex. Cole Harbour, NS, CAN
collegefree_agentStringCollege attended

ex. Michigan
experiencefree_agentunsignedByteNumber of years played in the NHL
first_namefree_agentStringFirst name of a player

ex. Sidney
full_namefree_agentStringFull name of a player

ex. Sidney Crosby
handednessfree_agentStringDominant hand of a player

ex. L, R
heightfree_agentunsignedByteHeight in inches
idfree_agentGUIDUnique ID of a player

ex. 433de553-0f24-11e2-8525-18a905767e44
last_namefree_agentStringLast name of a player

ex. Crosby
positionfree_agentStringPosition of a player

NA, D, F, F-D, G
primary_positionfree_agentStringPrimary position of a player

NA, C, D, G, LW, RW
referencefree_agentStringLeague reference ID of a player

ex. 8471675
statusfree_agentStringStatus of a player

FA (Free Agent)
updatedfree_agentdateTimeTimestamp of a change to a free agent status

ex. 2026-04-17T02:30:00+00:00
weightfree_agentunsignedShortWeight in lbs.
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

br (Brazilian Portuguese), en (English), es (Spanish), fr (French), ru (Russian), zh (Simplified Chinese)

Allowed:
string
enum
required
Defaults to json

Format returned

xml, json

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json