Competitions Endpoints

Search Competitions

curl -X GET "https://your-domain.com/api/competitions/search?keyword=premier" \
  -H "X-API-Key: your-api-key-here"

Search for football competitions and leagues by name or slug using trigram similarity. Returns up to 10 matched competitions ordered by ID.

Query Parameters

string

required

Keyword to search for in competition names or slugs. Supports fuzzy matching and accent-insensitive search.

Response

Returns an array of up to 10 matching competitions.

integer

Unique identifier for the competition

string

Full name of the competition (e.g., “Premier League”, “UEFA Champions League”)

string

URL-friendly slug for the competition

string

URL to the competition’s logo image

string

URL to the competition’s logo image (dark theme version)

string

ISO 2-letter country code for domestic competitions (e.g., “GB”, “ES”, “FR”). Null for international competitions.

[
  {
    "id": 1,
    "name": "Premier League",
    "slug": "premier-league-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/competitions/premier-league.png",
    "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/premier-league-dark.png",
    "country": "GB"
  },
  {
    "id": 5,
    "name": "UEFA Champions League",
    "slug": "uefa-champions-league-kits",
    "logo": "https://www.footballkitarchive.com/images/logos/competitions/ucl.png",
    "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/ucl-dark.png",
    "country": null
  }
]

Examples

curl -X GET "https://your-domain.com/api/competitions/search?keyword=premier"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=champions"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=liga"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=serie"

curl -X GET "https://your-domain.com/api/competitions/search?keyword=brasileiro"
# Returns "Campeonato Brasileiro Série A"

Results are cached for optimal performance. The search uses trigram word similarity for fuzzy matching.

Get Competition by ID

curl -X GET "https://your-domain.com/api/competitions/1" \
  -H "X-API-Key: your-api-key-here"

Retrieve detailed information about a specific competition by its ID.

Path Parameters

integer

required

The unique identifier of the competition

Response

integer

Unique identifier for the competition

string

Full name of the competition

string

URL-friendly slug for the competition

string

URL to the competition’s logo image

string

URL to the competition’s logo image (dark theme version)

string

ISO 2-letter country code for domestic competitions. Null for international competitions.

{
  "id": 1,
  "name": "Premier League",
  "slug": "premier-league-kits",
  "logo": "https://www.footballkitarchive.com/images/logos/competitions/premier-league.png",
  "logo_dark": "https://www.footballkitarchive.com/images/logos/competitions/premier-league-dark.png",
  "country": "GB"
}

Competition Types

The Football Kit Archive includes kits from various competition types:

Domestic Leagues

Premier League (England)
La Liga (Spain)
Serie A (Italy)
Bundesliga (Germany)
Ligue 1 (France)
Eredivisie (Netherlands)
Primeira Liga (Portugal)
Championship (England)
And many more domestic leagues worldwide…

International Club Competitions

UEFA Champions League
UEFA Europa League
UEFA Conference League
Copa Libertadores
Copa Sudamericana
CAF Champions League
AFC Champions League

International Tournaments

FIFA World Cup
UEFA European Championship
Copa América
Africa Cup of Nations
Asian Cup

Domestic Cups

FA Cup (England)
Copa del Rey (Spain)
Coppa Italia (Italy)
DFB-Pokal (Germany)
Coupe de France (France)
And many more domestic cup competitions…

Use the search endpoint to discover all available competitions in the database.

Overview

Endpoints

Advanced

Competitions Endpoints

Search Competitions

Query Parameters

Response

Examples

Get Competition by ID

Path Parameters

Response

Competition Types

Domestic Leagues

International Club Competitions

International Tournaments

Domestic Cups

​Search Competitions

​Query Parameters

​Response

​Examples

​Get Competition by ID

​Path Parameters

​Response

​Competition Types

​Domestic Leagues

​International Club Competitions

​International Tournaments

​Domestic Cups

Search Competitions

Query Parameters

Response

Examples

Get Competition by ID

Path Parameters

Response

Competition Types

Domestic Leagues

International Club Competitions

International Tournaments

Domestic Cups