# GET /v2/transfers

Group: Players

A feed of the newest football transfers from all leagues, 50 per page, built from the same Transfer objects as team transfer lists. Order it by date (newest move first), by fee (largest first) or by player popularity, Filters narrow it to one league (moves to or from its clubs), a position, a nationality and an age range.

Plans: Every plan, Free included.

Note: Covers football alone, the only sport for which the source maintains this feed. latest orders moves by the date they take effect, which means a loan expiring today is listed next to a signing announced today. Releases and moves into free agency end at "No team" — to stays null and toName holds that label. The feed updates every 30 minutes.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sort` | query | no | latest \| fee \| popular; latest when omitted |
| `league` | query | no | league id; keeps only moves into or out of that league’s clubs |
| `position` | query | no | goalkeeper \| defender \| midfielder \| forward |
| `nationality` | query | no | two-letter country code in the form Country.code uses, case-insensitive (England EN, Scotland SX, Wales WA, Northern Ireland NX) |
| `minAge` | query | no | minimum player age in whole years, 15–45 |
| `maxAge` | query | no | maximum player age in whole years, 15–45; must not be lower than minAge |
| `page` | query | no | page number from 0 to 50 (defaults to 0) |

## Response

- `data`: `Transfer[]`
- `meta`: sort, league, position, nationality, minAge, maxAge, page, count, hasNextPage
- Objects: Transfer (https://datasportsapi.com/markdown/reference.md#transfer)

## Errors

- 400 bad_request — sort or position takes a value not listed above, nationality is not a country code, an age falls outside 15–45 or minAge exceeds maxAge, or page is outside 0–50
- 404 not_found — DataSportsAPI has never assigned this league 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/transfers"
```

TypeScript:

```ts
const { data, meta } = await client.transfers.list();
for await (const page of client.transfers.listPages()) { … }
```

Python:

```python
res = client.transfers.list()
for page in client.transfers.list_pages(): ...
```

Go:

```go
res, err := client.Transfers.List(ctx, &datasportsapi.TransfersListParams{})
for page, err := range client.Transfers.ListPages(ctx, &datasportsapi.TransfersListParams{}) { … }
```

CLI:

```bash
$ dsa transfers list
$ dsa transfers list --all -o csv
```

## Example response

```json
{ "data": [ { "player": { "id": 5120, "name": "Enzo Fernández", "slug": "enzo-fernandez", "shortName": "E. Fernández", "image": "…" },
      "type": "transfer", "date": "2026-09-01",
      "from": { "id": 3790, "name": "Chelsea", … }, "fromName": "Chelsea",
      "to": { "id": 3802, "name": "Manchester City", … }, "toName": "Manchester City",
      "fee": { "amount": 145000000, "currency": "EUR" }, "freeTransfer": false, "draft": null }, … ],
  "meta": { "sort": "fee", "league": null, "position": null, "nationality": null, "minAge": null, "maxAge": null, "page": 0, "count": 50, "hasNextPage": true } }
```

---

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/transfers-list/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
