Data API · Teams
List teams
GET/api/v1/datas/teams
Returns teams available to the authenticated account.
Bearer authentication required · service: data_apiReference only — this page never sends API requests or exposes token controls.
Response formats
When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| page | integer | Optional | Page number. Default: 1. Minimum 1. |
| perPage | integer | Optional | Items per page. Default: 20. Minimum 1; maximum 100. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| items | array | Team records. |
| items[].id | integer | Team ID. |
| items[].name | string|null | Team name. |
| items[].logo | string|null | Team logo URL. |
| items[].shortName | string|null | Team short name. |
| items[].teamType | string|null | Team type (for example Club or National). |
| items[].teamStatus | string|null | Team status. |
| items[].teamColor | string|null | Team color. |
| items[].providerId | string|integer|null | Provider identifier. |
| items[].competitions | array | Accessible competitions; present for Advanced API accounts. |
| items[].competitions[].id | integer | Competition ID. |
| items[].competitions[].name | string|null | Competition name. |
| items[].competitions[].shortName | string|null | Competition short name. |
| items[].competitions[].dateStart | string|null | Competition start date. |
| items[].competitions[].dateEnd | string|null | Competition end date. |
| items[].competitions[].competitionFormatId | integer|null | Competition format ID. |
| items[].competitions[].countryId | integer|null | Country ID. |
| items[].competitions[].countryName | string|null | Country name. |
| items[].competitions[].logo | string|null | Competition logo URL. |
| items[].competitions[].providerId | integer|null | Provider identifier. |
| meta | object | Pagination metadata. |
| meta.currentPage | integer | Current page number. |
| meta.perPage | integer | Requested page size. |
| meta.total | integer | Total number of matching records. |
| meta.lastPage | integer | Last available page number. |
| meta.from | integer|null | Position of the first item on this page. |
| meta.to | integer|null | Position of the last item on this page. |
| links | object | Pagination URLs. |
| links.first | string | URL of the first page. |
| links.last | string | URL of the last page. |
| links.previous | string|null | URL of the previous page, when available. |
| links.next | string|null | URL of the next page, when available. |