---
title: "Check text contrast"
method: POST
path: "/api/v1/check-contrast"
---

# Check text contrast

`POST /api/v1/check-contrast`

## Request

- Base URL: `https://pickshade.com`
- URL: `https://pickshade.com/api/v1/check-contrast`
- Auth: none declared

Check text contrast against a background with both WCAG 2 (ratio, AA and AAA for normal and large text) and APCA (Lc value and the usage level it allows). Also suggests the nearest text color that passes AA and AAA while keeping its hue.

## Request body

- object
  - `text` string, required: Text or foreground color
  - `background` string, required: Background color

## 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)