---
title: "Describe a color"
method: GET
path: "/api/v1/parse-color"
---

# Describe a color

`GET /api/v1/parse-color`

## Request

- Base URL: `https://pickshade.com`
- URL: `https://pickshade.com/api/v1/parse-color`
- Auth: none declared

Read any color and describe it: HEX, RGB, HSL and OKLCH values, the closest human name, the closest Tailwind class, its hue family, whether it fits sRGB and Display P3, and which text color, white or black, reads better on it.

## Query parameters

- `color` string, required: Any color: #ff5733, rgb(255 87 51), hsl(11 100% 60%), oklch(68% 0.21 34), a CSS or common name like navy, or a Tailwind class like sky-500
- `locale` 'en' | 'ru': Language for color names

## Response `200`

Result

## Other responses

- `400`: Invalid input
- `429`: Too many requests. See the Retry-After header

---

[API](https://skmtc.dev/pickshade/apis/pickshade-color-api.md) · [All operations](https://skmtc.dev/pickshade/apis/pickshade-color-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickshade/apis/pickshade-color-api/revisions/00f0b7c55ea7?raw)