# GET /v2/players/{id}/attributes

Group: Players

Attribute ratings (0–100) for a football player from the source’s scouting model: attacking, technical, tactical, defending and creativity, or for a goalkeeper saves, anticipation, ball distribution, aerial and tactical. Includes current and earlier-year values, the average for players in the same position, strengths and weaknesses, and the detailed positions the player covers.

Plans: Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.

Note: Keys belonging to the other profile are null — a goalkeeper, for example, has no attacking rating. history starts with the current values (yearsAgo 0, 1, 2, …). strengths / weaknesses draw from a closed set (PlayerCharacteristic) and can be empty.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | DataSportsAPI player id, a positive integer |

## Response

- `data`: `PlayerAttributes`
- Objects: PlayerAttributes (https://datasportsapi.com/markdown/reference.md#playerattributes)

## Errors

- 404 no_data — the source has no rating for this player, as with other sports and many lower leagues; 404 not_found — DataSportsAPI has never assigned this id

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/players/{id}/attributes"
```

TypeScript:

```ts
const { data, meta } = await client.players.attributes(id);
```

Python:

```python
res = client.players.attributes(id)
```

Go:

```go
res, err := client.Players.Attributes(ctx, id)
```

CLI:

```bash
$ dsa players attributes <id>
```

## Example response

```json
{ "data": {
    "current": { "yearsAgo": 0, "position": "forward", "attacking": 76, "technical": 67, "tactical": 59, "defending": 46, "creativity": 76,
                 "saves": null, "anticipation": null, "ballDistribution": null, "aerial": null },
    "history": [ { "yearsAgo": 0, … }, { "yearsAgo": 1, "attacking": 81, … }, … ],
    "positionAverage": { "yearsAgo": 0, "position": "forward", "attacking": 61, "technical": 54, "tactical": 43, "defending": 32, "creativity": 45, … },
    "strengths": ["penaltyTaking", "positioning", "highPressing"], "weaknesses": [], "positions": ["rightWinger"] },
  "meta": {} }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/players/attributes/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
