---
updatedAt: 2025-11-18T16:11:52.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/basketball/v5/llms.txt
---
# Free Agents
**NBA Free Agents** Detailed player information for all current free agents in the league.
### Update Frequency
300s Time To Live / Cache
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "nba",
"version": "5"
},
"servers": [
{
"url": "https://api.sportradar.com/nba/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v5/{language_code}/league/free_agents.{format}": {
"get": {
"summary": "Free Agents",
"description": "**NBA Free Agents** Detailed player information for all current free agents in the league.",
"operationId": "nba-free-agents",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`br` (Brazilian Portuguese), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `fr` (French), `id` (Indonesian), `it` (Italian), `ja` (Japanese), `ko` (Korean), `ru` (Russian), `tl` (Tagalog), `tr` (Turkish), `zh` (simplified Chinese)",
"schema": {
"type": "string",
"enum": [
"br",
"de",
"el",
"en",
"es",
"fr",
"id",
"it",
"ja",
"ko",
"ru",
"tl",
"tr",
"zh"
],
"default": "en"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"league\": {\n \"id\": \"4353138d-4c22-4396-95d8-5f587d2df25c\",\n \"name\": \"NBA\",\n \"alias\": \"NBA\"\n },\n \"free_agents\": [\n {\n \"id\": \"000e95a4-b901-42db-823f-e7d204d93278\",\n \"status\": \"FA\",\n \"full_name\": \"Daequan Cook\",\n \"first_name\": \"Daequan\",\n \"last_name\": \"Cook\",\n \"abbr_name\": \"D.Cook\",\n \"height\": 77,\n \"weight\": 209,\n \"position\": \"G\",\n \"primary_position\": \"NA\",\n \"experience\": \"6\",\n \"college\": \"Ohio State\",\n \"high_school\": \"Paul Laurence Dunbar (OH)\",\n \"birth_place\": \"Dayton, OH, USA\",\n \"birthdate\": \"1987-04-28\",\n \"updated\": \"2020-03-26T19:32:12Z\",\n \"rookie_year\": 2007\n },\n {\n \"id\": \"ffdd03c7-8be4-45a0-ad44-a7b49ffed1cb\",\n \"status\": \"FA\",\n \"full_name\": \"Stefhon Hannah\",\n \"first_name\": \"Stefhon\",\n \"last_name\": \"Hannah\",\n \"abbr_name\": \"S.Hannah\",\n \"height\": 73,\n \"weight\": 175,\n \"position\": \"G\",\n \"primary_position\": \"PG\",\n \"college\": \"Missouri\",\n \"high_school\": \"Hyde Park Career Academy\",\n \"birth_place\": \"Chicago, IL, USA\",\n \"birthdate\": \"1985-06-14\",\n \"updated\": \"2020-03-13T15:02:13Z\"\n }\n ]\n}\n"
}
},
"schema": {
"type": "object",
"properties": {
"league": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "4353138d-4c22-4396-95d8-5f587d2df25c"
},
"name": {
"type": "string",
"example": "NBA"
},
"alias": {
"type": "string",
"example": "NBA"
}
}
},
"free_agents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "000e95a4-b901-42db-823f-e7d204d93278"
},
"status": {
"type": "string",
"example": "FA"
},
"full_name": {
"type": "string",
"example": "Daequan Cook"
},
"first_name": {
"type": "string",
"example": "Daequan"
},
"last_name": {
"type": "string",
"example": "Cook"
},
"abbr_name": {
"type": "string",
"example": "D.Cook"
},
"height": {
"type": "integer",
"example": 77,
"default": 0
},
"weight": {
"type": "integer",
"example": 209,
"default": 0
},
"position": {
"type": "string",
"example": "G"
},
"primary_position": {
"type": "string",
"example": "NA"
},
"experience": {
"type": "string",
"example": "6"
},
"college": {
"type": "string",
"example": "Ohio State"
},
"high_school": {
"type": "string",
"example": "Paul Laurence Dunbar (OH)"
},
"birth_place": {
"type": "string",
"example": "Dayton, OH, USA"
},
"birthdate": {
"type": "string",
"example": "1987-04-28"
},
"updated": {
"type": "string",
"example": "2020-03-26T19:32:12Z"
},
"rookie_year": {
"type": "integer",
"example": 2007,
"default": 0
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```