Skip to main content
GET
Search / list football tournaments (competitions)

What it returns

Substring search over tournament names. Each result nests its category (the country, or International) and the season window (scheduled / scheduled_end), plus risk_tier and icon_path when resolved. The nested category is the football sport → category model in action: the country rides inside the tournament, never the routing key.

Authorizations

X-API-Key
string
header
required

Query Parameters

search
string | null

Substring match on tournament name

limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

The response is of type Response List Tournaments Soccer V1 Tournaments Get · object.

Last modified on June 20, 2026