Skip to main content

​
Overview

The Football Kit Archive API provides color information for kits, including primary and secondary colors. Colors are used for filtering kits and are returned with kit details.

​
Available Colors

The following colors are available for filtering kits:

White

Classic white color

Red

Classic red color

Blue

Classic blue color

Black

Classic black color

Yellow

Classic yellow color

Green

Classic green color

Sky blue

Light blue shade

Navy

Dark blue shade

Orange

Classic orange color

Gray

Neutral gray color

Claret

Deep burgundy red

Purple

Classic purple color

Pink

Classic pink color

Brown

Classic brown color

Gold

Metallic gold color

Silver

Metallic silver color

Off-white

Cream or off-white shade

​
Color Schema

When colors are returned in API responses, they follow this schema:
​
name
string
The name of the color (e.g., “Red”, “Blue”, “White”)
​
color
string
Hex color code representing the color (e.g., “#FF0000”, “#0000FF”, “#FFFFFF”)

​
Example Response

{
  "name": "Red",
  "color": "#DA020E"
}

​
Using Colors in Kit Filtering

​
Filter by Primary Color

curl -X GET "https://your-domain.com/api/kits?primary_color=Red" \
  -H "X-API-Key: your-api-key-here"
Filter kits by their primary (dominant) color.
​
primary_color
string
Must be one of the available colors listed above

​
Filter by Secondary Colors

curl -X GET "https://your-domain.com/api/kits?secondary_color=White&secondary_color=Blue" \
  -H "X-API-Key: your-api-key-here"
Filter kits by their secondary (accent) colors. You can specify multiple secondary colors.
​
secondary_color
array
Can specify multiple values. Each must be one of the available colors listed above

​
Combined Color Filtering

curl -X GET "https://your-domain.com/api/kits?primary_color=Red&secondary_color=White&secondary_color=Black" \
  -H "X-API-Key: your-api-key-here"
Filter kits that have a specific primary color AND specific secondary colors.

​
Color Information in Kit Details

When retrieving kit details via GET /api/kits/{kit_id}, color information is included: 
{
  "name": "Manchester United 2024-25 Home Kit",
  "slug": "manchester-united-2024-25-home-kit",
  "primary_color": {
    "name": "Red",
    "color": "#DA020E"
  },
  "secondary_color": [
    {
      "name": "White",
      "color": "#FFFFFF"
    },
    {
      "name": "Black",
      "color": "#000000"
    }
  ],
  "team": {
    "name": "Manchester United",
    "...": "..."
  },
  "...": "..."
}

​
Validation

When filtering by colors, ensure you use the exact color names as listed above. Invalid color names will result in a 400 Bad Request error.

​
Error Response

{
  "detail": "Invalid primary_color 'Redd'. Available options: White, Red, Blue, Black, Yellow, Green, Sky blue, Navy, Orange, Gray, Claret, Purple, Pink, Brown, Gold, Silver, Off-white"
}
Some popular color combinations for football kits:
  • Red & White - Traditional combination (e.g., Arsenal, Manchester United)
  • Blue & White - Classic combination (e.g., Chelsea, Everton)
  • Red & Blue - Distinctive combination (e.g., Barcelona, Crystal Palace)
  • Black & White - Bold contrast (e.g., Newcastle United, Juventus)
  • Claret & Blue - Traditional combination (e.g., Aston Villa, West Ham United)
  • Sky blue & White - Light combination (e.g., Manchester City, Napoli)
  • Yellow & Blue - Bright combination (e.g., Sweden national team)
  • Green & White - Fresh combination (e.g., Celtic, Sporting CP)
Use color filtering combined with other filters (club, season, design) to find specific kits.

​
Examples

curl -X GET "https://your-domain.com/api/kits?primary_color=Red"