---
title: "Search for colors by name"
method: GET
path: "/v1/names/"
---

# Search for colors by name

`GET /v1/names/`

Returns colors whose names contain the search string. The search is case-insensitive.
The search string must be at least 3 characters long.

## Response `200`

OK

- object
  - `colors` ColorBasic[] — Array of colors matching the search term
    - `name` string, required — Name of the closest color relative to the hex value provided
    - `hex` string, required — Hex value of the color (can differ from the requested hex value)
    - `rgb` object, required — RGB values
      - `r` integer, required
      - `g` integer, required
      - `b` integer, required
    - `hsl` object, required — HSL values. All percentages are represented as integers (e.g., 50% as `50`).
      - `h` number, required
      - `s` number, required
      - `l` number, required
    - `lab` object, required — LAB values
      - `l` number, required
      - `a` number, required
      - `b` number, required
    - `luminance` number, required — Luminance value
    - `luminanceWCAG` number, required — Luminance value according to WCAG
    - `bestContrast` 'black' | 'white' — The best contrasting color ('black' or 'white') for text on this color
    - `swatchImg` object, required — SVG representation of the color
      - `svgNamed` string, uri, required — URL to SVG representation of the color with the name
      - `svg` string, uri, required — URL to SVG representation of the color without the name

## Other responses

- `404` — NOT FOUND

---

[API](https://skmtc.dev/color/apis/color-name-api.md) · [All operations](https://skmtc.dev/color/apis/color-name-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/color/color-name-api/revisions/98f9f0ba5658/schema)