GET/api/v1/players/salaries/detail

Get a player's salaries

World Cup packageactivebetacoreAvailable (scoped)

Description

Returns the salary history for the given player id (suggested rate: up to 60 requests/min)

Access

Request: GET https://api.sports.csap.ai/api/v1/players/salaries/detail
Auth: Header X-API-Key: <your key> (Authorization: Bearer <key> also works; ?key= is still accepted but discouraged, because the key ends up in URLs and logs)
External keys: Available (scoped)External keys can call it, but only data inside the open scope is returned.
Rate limits: 3000 per minute · 200000 per day · Set per key (rate_per_min and quota_daily returned by /api/v1/account are authoritative; the numbers above are a trial key's). Beyond them the answer is 429. In addition, heavy requests such as whole-table snapshots and statistics lists without a match id are processed 2 at a time for the whole platform; a request that cannot get a slot receives 429 with Retry-After. Responses do not carry X-RateLimit-* headers for now. See the general guide

Request parameters 1

Parameter	Type	required	Example	Description
ids	string	required		Several ids, comma separated, 200 at most

Example request

curl "https://api.sports.csap.ai/api/v1/players/salaries/detail" \
  -H "X-API-Key: YOUR_API_KEY"

Try it

Example response

Real response with an external key at 09/11/2026, 14:29 UTC: HTTP 200, 649 rows, 281 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "age": 26,
      "annual": 7792362,
      "club": "AFC Bournemouth",
      "country": "BRA",
      "currency_src": "GBP",
      "expires_year": 2029,
      "fx_gbp_eur": 1.198825,
      "gross_annual_eur": 7792362,
      "gross_annual_src": 6500000,
      "gross_weekly_eur": 149853,
      "gross_weekly_src": 125000,
      "id": 1,
      "mode": null,
      "player_name": "Evanilson",
      "player_uid": 1433,
      "position": "F",
      "roster_status": "active",
      "salary": null,
      "source": "SXf1a9fe",
      "team_id": null,
      "updated_at": 1794215428171,
      "weekly": 149853,
      "year": null
    },
    {
      "age": 27,
      "annual": 6857279,
      "club": "AFC Bournemouth",
      "country": "NLD",
      "currency_src": "GBP",
      "expires_year": 2028,
      "fx_gbp_eur": 1.198825,
      "gross_annual_eur": 6857279,
      "gross_annual_src": 5720000,
      "gross_weekly_eur": 131871,
      "gross_weekly_src": 110000,
      "id": 2,
      "mode": null,
      "player_name": "Justin Kluivert",
      "player_uid": 1427,
      "position": "F",
      "roster_status": "active",
      "salary": null,
      "source": "SXf1a9fe",
      "team_id": null,
      "updated_at": 1794215428176,
      "weekly": 131871,
      "year": null
    }
  ],
  "message": "success",
  "success": true
}

Response fields 23

ageintegerAgeExample: 26

annualintegerAnnual salaryExample: 7792362

clubstringClubExample: "AFC Bournemouth"

countrystringCountry / regionExample: "BRA"

currency_srcstringExample: "GBP"

expires_yearintegernullableExample: 2029

fx_gbp_eurnumberExample: 1.198825

gross_annual_eurintegerExample: 7792362

gross_annual_srcintegerExample: 6500000

gross_weekly_eurintegerExample: 149853

gross_weekly_srcintegerExample: 125000

idintegerRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)Example: 1

modenullnullableUnit

player_namestringPlayer nameExample: "Evanilson"

player_uidintegernullableExample: 1433

positionstringPositionExample: "F"

roster_statusstringExample: "active"

salarynullnullableSalary

sourcestringSource code (S1, S2…)Example: "SXf1a9fe"

team_idnullnullableTeam id

updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)Example: 1794215428171

weeklyintegerWeekly salaryExample: 149853

yearnullnullableYear

Errors

HTTP	message	When
401	`missing API key / unauthorized`	No X-API-Key, or the key is invalid or disabled
400	`bad param …`	Malformed parameter (e.g. id is neither a number nor u<uid>)
301	`match merged into <gmid>`	Queried by an old match id that has been merged into a new gmid: Location points to the new address and the body carries moved_to
404	`not found`	The match / team / competition does not exist, or is outside what this key can see (external keys see only matches inside the open coverage)
429	`rate limit exceeded / daily quota exceeded`	The key's per-minute rate or daily quota is exceeded
429	`server busy, retry later`	The server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500	`query error`	The query failed on the server; you may retry