Players
Search players by name or filter by team. Fetch individual player profiles.
List players
GET/api/public/v1/players
Query parameters
| Parameter | Type | Description |
|---|---|---|
| search optional | string | Case-insensitive full name search. |
| team_id optional | string | Team public ID to filter squad members. |
| page / per_page optional | integer | Pagination. Default: page=1, per_page=20, max=100. |
http
GET /api/public/v1/players?search=messi&per_page=5 Authorization: Bearer sk_live_xxxxxxxxxxxxx # Filter by team GET /api/public/v1/players?team_id=team_Nb8itbVl
json
{
"data": [
{
"id": "player_x2f3ka",
"first_name": "Lionel",
"last_name": "Messi",
"full_name": "Lionel Andrés Messi",
"short_name": "L. Messi",
"position": "Forward",
"date_of_birth": "1987-06-24",
"country_code": "ARG",
"height_cm": 170
}
],
"meta": { "page": 1, "per_page": 5, "total": 1 }
}Get player
GET/api/public/v1/players/:id
Path parameters
| Parameter | Type | Description |
|---|---|---|
| id required | string | Player public ID. |
http
GET /api/public/v1/players/player_x2f3ka Authorization: Bearer sk_live_xxxxxxxxxxxxx
json
{
"data": {
"id": "player_x2f3ka",
"first_name": "Lionel",
"last_name": "Messi",
"full_name": "Lionel Andrés Messi",
"short_name": "L. Messi",
"position": "Forward",
"date_of_birth": "1987-06-24",
"country_code": "ARG",
"country_name": "Argentina",
"height_cm": 170
}
}