Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Statorium Players API
version: 1.0.0
contact:
name: Statorium Support
url: https://statorium.com/
termsOfService: https://statorium.com/
description: 'Operations tagged Players across 3 of this provider''s published API definitions: statorium-american-football-api-openapi.yml, statorium-basketball-api-openapi.yml, statorium-football-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.statorium.com/api/v1
description: Statorium API Server
security:
- apiKey: []
tags:
- name: Players
description: Access NFL player profiles, news, and statistics.
paths:
/nfl/players/{playerId}/:
get:
operationId: getNflPlayer
summary: Get NFL Player
description: Returns detailed information about an NFL player including profile, career stats, and current season statistics.
tags:
- Players
parameters:
- $ref: '#/components/parameters/ApiKeyParam'
- name: playerId
in: path
required: true
schema:
type: integer
description: The unique player identifier.
responses:
'200':
description: NFL player details
content:
application/json:
schema:
$ref: '#/components/schemas/Player'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
servers:
- url: https://api.statorium.com/api/v1
description: Statorium API Server
/basketball/players/{playerId}/:
get:
operationId: getBasketballPlayer
summary: Get Basketball Player
description: Returns detailed information about a basketball player including profile and season statistics.
tags:
- Players
parameters:
- $ref: '#/components/parameters/ApiKeyParam'
- name: playerId
in: path
required: true
schema:
type: integer
description: The unique player identifier.
responses:
'200':
description: Player details
content:
application/json:
schema:
$ref: '#/components/schemas/Player_2'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
servers:
- url: https://api.statorium.com/api/v1
description: Statorium API Server
/players/{playerId}/:
get:
operationId: getPlayer
summary: Get Player by ID
description: Retrieves detailed information about a specific player including profile, career history, and season statistics.
tags:
- Players
parameters:
- $ref: '#/components/parameters/ApiKeyParam_2'
- name: playerId
in: path
required: true
schema:
type: integer
description: The unique identifier of the player.
responses:
'200':
description: Player details
content:
application/json:
schema:
$ref: '#/components/schemas/Player_3'
'401':
$ref: '#/components/responses/Unauthorized_2'
'404':
$ref: '#/components/responses/NotFound_2'
servers:
- url: https://api.statorium.com/api/v1
description: Statorium API Server
components:
schemas:
Player:
type: object
properties:
id:
type: integer
name:
type: string
position:
type: string
teamId:
type: integer
jerseyNumber:
type: integer
college:
type: string
experience:
type: integer
description: Years of NFL experience.
status:
type: string
enum:
- active
- injured
- practice_squad
- free_agent
Player_2:
type: object
properties:
id:
type: integer
name:
type: string
position:
type: string
teamId:
type: integer
jerseyNumber:
type: integer
nationality:
type: string
height:
type: string
weight:
type: string
Player_3:
type: object
description: A football player with full details.
properties:
id:
type: integer
description: Unique identifier for the player.
name:
type: string
description: Player name.
nameTranslated:
type: string
description: Translated player name if available.
nationality:
type: string
description: Player nationality.
position:
type: string
description: Player position (e.g., Forward, Midfielder).
dateOfBirth:
type: string
format: date
description: Player date of birth.
teamId:
type: integer
description: Current team ID.
shirtNumber:
type: integer
description: Player shirt number.
responses:
NotFound:
description: Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
NotFound_2:
description: Resource not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message indicating the resource was not found.
Unauthorized_2:
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: Error message describing the authentication failure.
parameters:
ApiKeyParam:
name: apikey
in: query
required: true
schema:
type: string
description: Your Statorium API token.
ApiKeyParam_2:
name: apikey
in: query
required: true
schema:
type: string
description: Your Statorium API token for authentication.
securitySchemes:
apiKey:
type: apiKey
in: query
name: apikey
description: API token provided upon subscription purchase.
x-refined-from:
- statorium-american-football-api-openapi.yml
- statorium-basketball-api-openapi.yml
- statorium-football-api-openapi.yml