# List team of the week periods (v1)

Returns team of the week periods, newest first, with id, type, name and round. Use the id with Get Sports Team of the Week. Nothing found returns `data: null`.

- Platform: Sofascore
- Request: `GET https://api.toolzerhub.com/v1/sofascore/tournament/season/team-of-the-week/periods`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/sofascore/seasons/get-sports-team-of-the-week-periods

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | query | yes | integer | Tournament id (uniqueTournament.id), such as 17 for the Premier League. Find one with Search Sports. |
| `season_id` | query | yes | integer | Season id. List seasons with Get Sports Tournament (seasons). |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/sofascore/tournament/season/team-of-the-week/periods?id=<id>&season_id=<season_id>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.
