Skip to content
Color API

Introduction

Welcome to the Color API documentation. Our API provides programmatic access to color conversion, generation, and manipulation tools.

Getting Started

Section titled “Getting Started”

To get started with the Color API:

  1. Sign up for an account at color.koval.dev
  2. Get your API key by emailing m@koval.dev
  3. Make your first request using the examples below

Quick Example

Section titled “Quick Example”
Terminal window
curl "https://color.koval.dev/v1/convert?value=%23ff0000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "input": "#ff0000",
  "formats": {
    "hex": "#FF0000",
    "rgb": { "r": 255, "g": 0, "b": 0 },
    "hsl": { "h": 0, "s": 100, "l": 50 }
  }
}

Features

Section titled “Features”
  • Color Conversion - Convert between HEX, RGB, HSL, OKLCH, and more
  • Accessibility - WCAG contrast checking, APCA scores
  • Color Names - Find closest named colors from CSS, XKCD, Meodai datasets
  • Palette Generation - Generate harmonious color palettes
  • Color Repair - Fix out-of-gamut colors for accessibility compliance

Rate Limits

Section titled “Rate Limits”
  • Free tier: 5,000 requests/month (25 RPM)
  • Higher tiers available with increased limits
  • See Rate Limits for details

Next Steps

Section titled “Next Steps”