NHL team roster API
Use the NHL team roster API to retrieve roster entries and record identities and titles as structured JSON from NHL. Supply team selector in the query; optionally select season to set the requested scope. Use these results to compare squad composition for a team and season or organize registered-player reference lists. The documented source-page link form identifies the requested entry directly and lets you reuse an existing source-page reference. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.
- Selected price
- $0.002 / billing creditPublished pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
apishCurrent NHL team roster API · GET · View API reference | $0.002 / billing credit | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
cachedbooleancountintegercredits_usedintegerdefensemenobject[]birth_citystringbirth_countrystringbirth_datestringbirth_state_provincestringfirst_namestringheadshotstringheight_in_centimetersintegerheight_in_inchesintegeridintegerlast_namestringposition_codestringshoots_catchesstringsweater_numberintegerweight_in_kilogramsintegerweight_in_poundsinteger
fetched_atstringforwardsobject[]birth_citystringbirth_countrystringbirth_datestringbirth_state_provincestringfirst_namestringheadshotstringheight_in_centimetersintegerheight_in_inchesintegeridintegerlast_namestringposition_codestringshoots_catchesstringsweater_numberintegerweight_in_kilogramsintegerweight_in_poundsinteger
goaliesobject[]birth_citystringbirth_countrystringbirth_datestringfirst_namestringheadshotstringheight_in_centimetersintegerheight_in_inchesintegeridintegerlast_namestringposition_codestringshoots_catchesstringsweater_numberintegerweight_in_kilogramsintegerweight_in_poundsintegerbirth_state_provincestring
seasonstringteamstring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
cached?: boolean;
count?: number;
credits_used?: number;
defensemen?: Array<{
birth_city?: string;
birth_country?: string;
birth_date?: string;
birth_state_province?: string;
first_name?: string;
headshot?: string;
height_in_centimeters?: number;
height_in_inches?: number;
id?: number;
last_name?: string;
position_code?: string;
shoots_catches?: string;
sweater_number?: number;
weight_in_kilograms?: number;
weight_in_pounds?: number;
}>;
fetched_at?: string;
forwards?: Array<{
birth_city?: string;
birth_country?: string;
birth_date?: string;
birth_state_province?: string;
first_name?: string;
headshot?: string;
height_in_centimeters?: number;
height_in_inches?: number;
id?: number;
last_name?: string;
position_code?: string;
shoots_catches?: string;
sweater_number?: number;
weight_in_kilograms?: number;
weight_in_pounds?: number;
}>;
goalies?: Array<{
birth_city?: string;
birth_country?: string;
birth_date?: string;
first_name?: string;
headshot?: string;
height_in_centimeters?: number;
height_in_inches?: number;
id?: number;
last_name?: string;
position_code?: string;
shoots_catches?: string;
sweater_number?: number;
weight_in_kilograms?: number;
weight_in_pounds?: number;
birth_state_province?: string;
}>;
season?: string;
team?: string;
};- Method
- GET
- Endpoint
https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster?output=json&raw=0&team=EDM' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
team | URL query parametersquery | string | Yes | Team abbreviation (`EDM`, `TOR`, `NYR` ...), team id or an nhl.com team link. |
season | URL query parametersquery | string | No | Season as `2025-26`, `20252026` or its first year `2025`; the current season by default. |
raw | URL query parametersquery | string | No | 0 leaves out the bulky `raw` source blocks (often 10-30x smaller). enum: "0", "1" |
fields | URL query parametersquery | string | No | Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included. |
fresh | URL query parametersquery | string | No | 1 skips the 24-hour cache and fetches live. enum: "1" |
output | URL query parametersquery | string | No | JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported. enum: "json" |
records | URL query parametersquery | string | No | With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row. |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Documented HTTP 200 Example from the provider's documentation. Field values in your results will differ.
{
"cached": false,
"count": 27,
"credits_used": 1,
"defensemen": [
{
"birth_city": "Oakville",
"birth_country": "CAN",
"birth_date": "1999-10-20",
"birth_state_province": "ON",
"first_name": "Evan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480803.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8480803,
"last_name": "Bouchard",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 2,
"weight_in_kilograms": 89,
"weight_in_pounds": 196
},
{
"birth_city": "Borlange",
"birth_country": "SWE",
"birth_date": "1990-05-24",
"first_name": "Mattias",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475218.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8475218,
"last_name": "Ekholm",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 14,
"weight_in_kilograms": 96,
"weight_in_pounds": 211
},
{
"birth_city": "Eau Claire",
"birth_country": "USA",
"birth_date": "2000-05-23",
"birth_state_province": "WI",
"first_name": "Ty",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480834.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8480834,
"last_name": "Emberson",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 49,
"weight_in_kilograms": 92,
"weight_in_pounds": 202
},
{
"birth_city": "Ufa",
"birth_country": "RUS",
"birth_date": "2002-01-10",
"first_name": "Shakir",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482166.png",
"height_in_centimeters": 196,
"height_in_inches": 77,
"id": 8482166,
"last_name": "Mukhamadullin",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 85,
"weight_in_kilograms": 93,
"weight_in_pounds": 205
},
{
"birth_city": "Boston",
"birth_country": "USA",
"birth_date": "1993-03-26",
"birth_state_province": "MA",
"first_name": "Connor",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8476473.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8476473,
"last_name": "Murphy",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 5,
"weight_in_kilograms": 95,
"weight_in_pounds": 210
},
{
"birth_city": "West Bloomfield",
"birth_country": "USA",
"birth_date": "2000-08-06",
"birth_state_province": "MI",
"first_name": "Alec",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480831.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8480831,
"last_name": "Regula",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 75,
"weight_in_kilograms": 98,
"weight_in_pounds": 216
},
{
"birth_city": "Milton",
"birth_country": "USA",
"birth_date": "1997-02-11",
"birth_state_province": "MA",
"first_name": "Ryan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478854.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478854,
"last_name": "Shea",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 6,
"weight_in_kilograms": 88,
"weight_in_pounds": 195
},
{
"birth_city": "Toronto",
"birth_country": "CAN",
"birth_date": "1996-02-20",
"birth_state_province": "ON",
"first_name": "Jake",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478013.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478013,
"last_name": "Walman",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 96,
"weight_in_kilograms": 95,
"weight_in_pounds": 210
}
],
"fetched_at": "2026-11-19T12:22:40.987Z",
"forwards": [
{
"birth_city": "Fort Saskatchewan",
"birth_country": "CAN",
"birth_date": "2003-01-04",
"birth_state_province": "AB",
"first_name": "Colton",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482703.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8482703,
"last_name": "Dach",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 34,
"weight_in_kilograms": 98,
"weight_in_pounds": 215
},
{
"birth_city": "Georgetown",
"birth_country": "CAN",
"birth_date": "1995-07-04",
"birth_state_province": "ON",
"first_name": "Jason",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477450.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8477450,
"last_name": "Dickinson",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 16,
"weight_in_kilograms": 93,
"weight_in_pounds": 204
},
{
"birth_city": "Cologne",
"birth_country": "DEU",
"birth_date": "1995-10-27",
"first_name": "Leon",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477934.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8477934,
"last_name": "Draisaitl",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 29,
"weight_in_kilograms": 98,
"weight_in_pounds": 215
},
{
"birth_city": "Barrie",
"birth_country": "CAN",
"birth_date": "1999-09-13",
"birth_state_province": "ON",
"first_name": "Alex",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480029.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8480029,
"last_name": "Formenton",
"position_code": "L",
"shoots_catches": "L",
"sweater_number": 26,
"weight_in_kilograms": 88,
"weight_in_pounds": 193
},
{
"birth_city": "St. Louis",
"birth_country": "USA",
"birth_date": "1998-02-11",
"birth_state_province": "MO",
"first_name": "Trent",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8479365.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8479365,
"last_name": "Frederic",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 10,
"weight_in_kilograms": 99,
"weight_in_pounds": 218
},
{
"birth_city": "Sundsvall",
"birth_country": "SWE",
"birth_date": "2000-06-29",
"first_name": "Filip",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480842.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8480842,
"last_name": "Hallander",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 19,
"weight_in_kilograms": 94,
"weight_in_pounds": 207
},
{
"birth_city": "Toronto",
"birth_country": "CAN",
"birth_date": "1992-06-09",
"birth_state_province": "ON",
"first_name": "Zach",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475786.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8475786,
"last_name": "Hyman",
"position_code": "L",
"shoots_catches": "R",
"sweater_number": 18,
"weight_in_kilograms": 94,
"weight_in_pounds": 208
},
{
"birth_city": "Danderyd",
"birth_country": "SWE",
"birth_date": "1992-12-08",
"first_name": "Mattias",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477406.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477406,
"last_name": "Janmark",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 13,
"weight_in_kilograms": 93,
"weight_in_pounds": 205
},
{
"birth_city": "Rochester",
"birth_country": "USA",
"birth_date": "1998-02-17",
"birth_state_province": "MI",
"first_name": "Max",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8479368.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8479368,
"last_name": "Jones",
"position_code": "L",
"shoots_catches": "L",
"sweater_number": 46,
"weight_in_kilograms": 102,
"weight_in_pounds": 225
},
{
"birth_city": "Laval",
"birth_country": "CAN",
"birth_date": "1997-02-09",
"birth_state_province": "QC",
"first_name": "Mathieu",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478472.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478472,
"last_name": "Joseph",
"position_code": "R",
"shoots_catches": "L",
"sweater_number": 21,
"weight_in_kilograms": 85,
"weight_in_pounds": 188
},
{
"birth_city": "Kuopio",
"birth_country": "FIN",
"birth_date": "1996-07-23",
"first_name": "Kasperi",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477953.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477953,
"last_name": "Kapanen",
"position_code": "R",
"shoots_catches": "R",
"sweater_number": 42,
"weight_in_kilograms": 89,
"weight_in_pounds": 197
},
{
"birth_city": "Richmond Hill",
"birth_country": "CAN",
"birth_date": "1997-01-13",
"birth_state_province": "ON",
"first_name": "Connor",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478402.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8478402,
"last_name": "McDavid",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 97,
"weight_in_kilograms": 86,
"weight_in_pounds": 190
},
{
"birth_city": "Detroit",
"birth_country": "USA",
"birth_date": "2002-05-01",
"birth_state_province": "MI",
"first_name": "Owen",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8486161.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8486161,
"last_name": "Michaels",
"position_code": "R",
"shoots_catches": "R",
"sweater_number": 43,
"weight_in_kilograms": 83,
"weight_in_pounds": 184
},
{
"birth_city": "Burnaby",
"birth_country": "CAN",
"birth_date": "1993-04-12",
"birth_state_province": "BC",
"first_name": "Ryan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8476454.png",
"height_in_centimeters": 183,
"height_in_inches": 72,
"id": 8476454,
"last_name": "Nugent-Hopkins",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 93,
"weight_in_kilograms": 86,
"weight_in_pounds": 190
},
{
"birth_city": "Moscow",
"birth_country": "RUS",
"birth_date": "2001-06-24",
"first_name": "Vasily",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8481617.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8481617,
"last_name": "Podkolzin",
"position_code": "R",
"shoots_catches": "L",
"sweater_number": 92,
"weight_in_kilograms": 96,
"weight_in_pounds": 212
},
{
"birth_city": "St. Albert",
"birth_country": "CAN",
"birth_date": "2004-01-01",
"birth_state_province": "AB",
"first_name": "Matt",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8483512.png",
"height_in_centimeters": 175,
"height_in_inches": 69,
"id": 8483512,
"last_name": "Savoie",
"position_code": "C",
"shoots_catches": "R",
"sweater_number": 22,
"weight_in_kilograms": 82,
"weight_in_pounds": 180
}
],
"goalies": [
{
"birth_city": "Herning",
"birth_country": "DNK",
"birth_date": "1989-10-02",
"first_name": "Frederik",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475883.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8475883,
"last_name": "Andersen",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 30,
"weight_in_kilograms": 104,
"weight_in_pounds": 229
},
{
"birth_city": "Surrey",
"birth_country": "CAN",
"birth_date": "1995-04-29",
"birth_state_province": "BC",
"first_name": "Tristan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477465.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477465,
"last_name": "Jarry",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 35,
"weight_in_kilograms": 91,
"weight_in_pounds": 201
},
{
"birth_city": "Dollard-des-Ormeaux",
"birth_country": "CAN",
"birth_date": "2001-12-27",
"birth_state_province": "QC",
"first_name": "Devon",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482221.png",
"height_in_centimeters": 183,
"height_in_inches": 72,
"id": 8482221,
"last_name": "Levi",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 27,
"weight_in_kilograms": 85,
"weight_in_pounds": 187
}
],
"season": "20262027",
"team": "EDM"
}Composite rule pricing
Calculated from input parameters and actual returned quantities. Estimate the maximum cost before calling.
Base fee: $0.000000. One matching variant replaces the base fee. Matching add-ons and quantity charges are added.
| Fee item | Price | Metering source | When | Quantity limit |
|---|---|---|---|---|
| Actual API.SH credits consumed | $0.002000 / billing credit | Response · /credits_used · Numeric value | Always | 1 billing credit · Decimal places: 0 |
Each quantity charge is rounded before summing: ceil. Requests exceeding this cost limit are rejected; it is not a price cap: $0.002000.
Response quantities settle after the response. Before execution, the maximum quantity determines the reservation; unused reservation is released. Missing or invalid quantities are not treated as zero.
Pricing parameters and defaults
[]
Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# NHL team roster API
Use the NHL team roster API to retrieve roster entries and record identities and titles as structured JSON from NHL. Supply team selector in the query; optionally select season to set the requested scope. Use these results to compare squad composition for a team and season or organize registered-player reference lists. The documented source-page link form identifies the requested entry directly and lets you reuse an existing source-page reference. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.
## Available implementations
apish · NHL team roster API: https://openany.si/markets/apis/capabilities/nhl-team-roster-api?offering=31cba548-a96d-410b-b0a8-5cde242d1312 · $0.002 / billing credit
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/nhl-team-roster-api
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster
Price: $0.002 / billing credit
Provider: apish
Contract revision: 2
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster?output=json&raw=0&team=EDM' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'
```
## API contract
```json
{
"resource_type": "api",
"name": "NHL team roster API",
"endpoint": "https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster",
"method": "GET",
"content_type": "none",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "Team abbreviation (`EDM`, `TOR`, `NYR` ...), team id or an nhl.com team link.",
"location": "query",
"name": "team",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "Season as `2025-26`, `20252026` or its first year `2025`; the current season by default.",
"location": "query",
"name": "season",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "0 leaves out the bulky `raw` source blocks (often 10-30x smaller).",
"enum_values": [
"0",
"1"
],
"location": "query",
"name": "raw",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.",
"location": "query",
"name": "fields",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "1 skips the 24-hour cache and fetches live.",
"enum_values": [
"1"
],
"location": "query",
"name": "fresh",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.",
"enum_values": [
"json"
],
"location": "query",
"name": "output",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.",
"location": "query",
"name": "records",
"nullable": false,
"required": false,
"type": "string"
}
],
"billing": {
"currency": "USD",
"mode": "rules",
"parameters": [],
"policy_version": 2,
"sale": {
"addons": [],
"base_price_micro_usd": "0",
"max_cost_micro_usd": "2000",
"quantities": [
{
"id": "upstream_credits",
"label": "Actual API.SH credits consumed",
"max_quantity": "1",
"measure": "value",
"pointer": "/credits_used",
"price_micro_usd": "2000",
"quantity_scale": 0,
"source": "response",
"unit": "credit",
"unit_quantity": "1"
}
],
"rounding": "ceil",
"variants": []
}
},
"examples": [
{
"http_status": 200,
"name": "Official example · Live API.SH response · Minimal request",
"request": {
"body": null,
"headers": {},
"path": {},
"query": {
"output": "json",
"raw": "0",
"team": "EDM"
}
},
"response_body": {
"cached": false,
"count": 27,
"credits_used": 1,
"defensemen": [
{
"birth_city": "Oakville",
"birth_country": "CAN",
"birth_date": "1999-10-20",
"birth_state_province": "ON",
"first_name": "Evan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480803.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8480803,
"last_name": "Bouchard",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 2,
"weight_in_kilograms": 89,
"weight_in_pounds": 196
},
{
"birth_city": "Borlange",
"birth_country": "SWE",
"birth_date": "1990-05-24",
"first_name": "Mattias",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475218.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8475218,
"last_name": "Ekholm",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 14,
"weight_in_kilograms": 96,
"weight_in_pounds": 211
},
{
"birth_city": "Eau Claire",
"birth_country": "USA",
"birth_date": "2000-05-23",
"birth_state_province": "WI",
"first_name": "Ty",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480834.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8480834,
"last_name": "Emberson",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 49,
"weight_in_kilograms": 92,
"weight_in_pounds": 202
},
{
"birth_city": "Ufa",
"birth_country": "RUS",
"birth_date": "2002-01-10",
"first_name": "Shakir",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482166.png",
"height_in_centimeters": 196,
"height_in_inches": 77,
"id": 8482166,
"last_name": "Mukhamadullin",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 85,
"weight_in_kilograms": 93,
"weight_in_pounds": 205
},
{
"birth_city": "Boston",
"birth_country": "USA",
"birth_date": "1993-03-26",
"birth_state_province": "MA",
"first_name": "Connor",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8476473.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8476473,
"last_name": "Murphy",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 5,
"weight_in_kilograms": 95,
"weight_in_pounds": 210
},
{
"birth_city": "West Bloomfield",
"birth_country": "USA",
"birth_date": "2000-08-06",
"birth_state_province": "MI",
"first_name": "Alec",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480831.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8480831,
"last_name": "Regula",
"position_code": "D",
"shoots_catches": "R",
"sweater_number": 75,
"weight_in_kilograms": 98,
"weight_in_pounds": 216
},
{
"birth_city": "Milton",
"birth_country": "USA",
"birth_date": "1997-02-11",
"birth_state_province": "MA",
"first_name": "Ryan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478854.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478854,
"last_name": "Shea",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 6,
"weight_in_kilograms": 88,
"weight_in_pounds": 195
},
{
"birth_city": "Toronto",
"birth_country": "CAN",
"birth_date": "1996-02-20",
"birth_state_province": "ON",
"first_name": "Jake",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478013.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478013,
"last_name": "Walman",
"position_code": "D",
"shoots_catches": "L",
"sweater_number": 96,
"weight_in_kilograms": 95,
"weight_in_pounds": 210
}
],
"fetched_at": "2026-11-19T12:22:40.987Z",
"forwards": [
{
"birth_city": "Fort Saskatchewan",
"birth_country": "CAN",
"birth_date": "2003-01-04",
"birth_state_province": "AB",
"first_name": "Colton",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482703.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8482703,
"last_name": "Dach",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 34,
"weight_in_kilograms": 98,
"weight_in_pounds": 215
},
{
"birth_city": "Georgetown",
"birth_country": "CAN",
"birth_date": "1995-07-04",
"birth_state_province": "ON",
"first_name": "Jason",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477450.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8477450,
"last_name": "Dickinson",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 16,
"weight_in_kilograms": 93,
"weight_in_pounds": 204
},
{
"birth_city": "Cologne",
"birth_country": "DEU",
"birth_date": "1995-10-27",
"first_name": "Leon",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477934.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8477934,
"last_name": "Draisaitl",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 29,
"weight_in_kilograms": 98,
"weight_in_pounds": 215
},
{
"birth_city": "Barrie",
"birth_country": "CAN",
"birth_date": "1999-09-13",
"birth_state_province": "ON",
"first_name": "Alex",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480029.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8480029,
"last_name": "Formenton",
"position_code": "L",
"shoots_catches": "L",
"sweater_number": 26,
"weight_in_kilograms": 88,
"weight_in_pounds": 193
},
{
"birth_city": "St. Louis",
"birth_country": "USA",
"birth_date": "1998-02-11",
"birth_state_province": "MO",
"first_name": "Trent",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8479365.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8479365,
"last_name": "Frederic",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 10,
"weight_in_kilograms": 99,
"weight_in_pounds": 218
},
{
"birth_city": "Sundsvall",
"birth_country": "SWE",
"birth_date": "2000-06-29",
"first_name": "Filip",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8480842.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8480842,
"last_name": "Hallander",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 19,
"weight_in_kilograms": 94,
"weight_in_pounds": 207
},
{
"birth_city": "Toronto",
"birth_country": "CAN",
"birth_date": "1992-06-09",
"birth_state_province": "ON",
"first_name": "Zach",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475786.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8475786,
"last_name": "Hyman",
"position_code": "L",
"shoots_catches": "R",
"sweater_number": 18,
"weight_in_kilograms": 94,
"weight_in_pounds": 208
},
{
"birth_city": "Danderyd",
"birth_country": "SWE",
"birth_date": "1992-12-08",
"first_name": "Mattias",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477406.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477406,
"last_name": "Janmark",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 13,
"weight_in_kilograms": 93,
"weight_in_pounds": 205
},
{
"birth_city": "Rochester",
"birth_country": "USA",
"birth_date": "1998-02-17",
"birth_state_province": "MI",
"first_name": "Max",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8479368.png",
"height_in_centimeters": 191,
"height_in_inches": 75,
"id": 8479368,
"last_name": "Jones",
"position_code": "L",
"shoots_catches": "L",
"sweater_number": 46,
"weight_in_kilograms": 102,
"weight_in_pounds": 225
},
{
"birth_city": "Laval",
"birth_country": "CAN",
"birth_date": "1997-02-09",
"birth_state_province": "QC",
"first_name": "Mathieu",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478472.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8478472,
"last_name": "Joseph",
"position_code": "R",
"shoots_catches": "L",
"sweater_number": 21,
"weight_in_kilograms": 85,
"weight_in_pounds": 188
},
{
"birth_city": "Kuopio",
"birth_country": "FIN",
"birth_date": "1996-07-23",
"first_name": "Kasperi",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477953.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477953,
"last_name": "Kapanen",
"position_code": "R",
"shoots_catches": "R",
"sweater_number": 42,
"weight_in_kilograms": 89,
"weight_in_pounds": 197
},
{
"birth_city": "Richmond Hill",
"birth_country": "CAN",
"birth_date": "1997-01-13",
"birth_state_province": "ON",
"first_name": "Connor",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478402.png",
"height_in_centimeters": 188,
"height_in_inches": 74,
"id": 8478402,
"last_name": "McDavid",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 97,
"weight_in_kilograms": 86,
"weight_in_pounds": 190
},
{
"birth_city": "Detroit",
"birth_country": "USA",
"birth_date": "2002-05-01",
"birth_state_province": "MI",
"first_name": "Owen",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8486161.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8486161,
"last_name": "Michaels",
"position_code": "R",
"shoots_catches": "R",
"sweater_number": 43,
"weight_in_kilograms": 83,
"weight_in_pounds": 184
},
{
"birth_city": "Burnaby",
"birth_country": "CAN",
"birth_date": "1993-04-12",
"birth_state_province": "BC",
"first_name": "Ryan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8476454.png",
"height_in_centimeters": 183,
"height_in_inches": 72,
"id": 8476454,
"last_name": "Nugent-Hopkins",
"position_code": "C",
"shoots_catches": "L",
"sweater_number": 93,
"weight_in_kilograms": 86,
"weight_in_pounds": 190
},
{
"birth_city": "Moscow",
"birth_country": "RUS",
"birth_date": "2001-06-24",
"first_name": "Vasily",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8481617.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8481617,
"last_name": "Podkolzin",
"position_code": "R",
"shoots_catches": "L",
"sweater_number": 92,
"weight_in_kilograms": 96,
"weight_in_pounds": 212
},
{
"birth_city": "St. Albert",
"birth_country": "CAN",
"birth_date": "2004-01-01",
"birth_state_province": "AB",
"first_name": "Matt",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8483512.png",
"height_in_centimeters": 175,
"height_in_inches": 69,
"id": 8483512,
"last_name": "Savoie",
"position_code": "C",
"shoots_catches": "R",
"sweater_number": 22,
"weight_in_kilograms": 82,
"weight_in_pounds": 180
}
],
"goalies": [
{
"birth_city": "Herning",
"birth_country": "DNK",
"birth_date": "1989-10-02",
"first_name": "Frederik",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8475883.png",
"height_in_centimeters": 193,
"height_in_inches": 76,
"id": 8475883,
"last_name": "Andersen",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 30,
"weight_in_kilograms": 104,
"weight_in_pounds": 229
},
{
"birth_city": "Surrey",
"birth_country": "CAN",
"birth_date": "1995-04-29",
"birth_state_province": "BC",
"first_name": "Tristan",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8477465.png",
"height_in_centimeters": 185,
"height_in_inches": 73,
"id": 8477465,
"last_name": "Jarry",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 35,
"weight_in_kilograms": 91,
"weight_in_pounds": 201
},
{
"birth_city": "Dollard-des-Ormeaux",
"birth_country": "CAN",
"birth_date": "2001-12-27",
"birth_state_province": "QC",
"first_name": "Devon",
"headshot": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8482221.png",
"height_in_centimeters": 183,
"height_in_inches": 72,
"id": 8482221,
"last_name": "Levi",
"position_code": "G",
"shoots_catches": "L",
"sweater_number": 27,
"weight_in_kilograms": 85,
"weight_in_pounds": 187
}
],
"season": "20262027",
"team": "EDM"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · Live API.SH response · Minimal request
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 7
Review these request fields before running. Keep the published provider and request method unchanged.
team- Team abbreviation (`EDM`, `TOR`, `NYR` ...), team id or an nhl.com team link.
season- Season as `2025-26`, `20252026` or its first year `2025`; the current season by default.
raw- 0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
fields- Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
fresh- 1 skips the 24-hour cache and fetches live.
output- JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
records- With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/apish/nhl/v1/roster?output=json&raw=0&team=EDM' \ -X GET \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json'Check the response
Sample response · Documented HTTP 200
Sample response