Contrast Ratio Validator

List all saved contrast ratio check results

{
  "data": [
    {
      "id": "cr-001",
      "foreground_hex": "#1A1A2E",
      "background_hex": "#FFFFFF",
      "contrast_ratio": 14.73,
      "foreground_luminance": 0.011,
      "background_luminance": 1,
      "compliant_normal_text": true,
      "compliant_large_text": true,
      "created_at": "2026-03-26T09:00:00Z"
    },
    {
      "id": "cr-002",
      "foreground_hex": "#9E9E9E",
      "background_hex": "#FFFFFF",
      "contrast_ratio": 3.95,
      "foreground_luminance": 0.216,
      "background_luminance": 1,
      "compliant_normal_text": false,
      "compliant_large_text": true,
      "created_at": "2026-03-26T09:01:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

Get a specific contrast ratio result by ID

{
  "id": "cr-001",
  "foreground_hex": "#1A1A2E",
  "background_hex": "#FFFFFF",
  "contrast_ratio": 14.73,
  "foreground_luminance": 0.011,
  "background_luminance": 1,
  "compliant_normal_text": true,
  "compliant_large_text": true,
  "wcag_level": "AAA",
  "created_at": "2026-03-26T09:00:00Z"
}

Calculate and save a contrast ratio check

{
  "foreground_hex": "#1A1A2E",
  "background_hex": "#FFFFFF",
  "context": "body-text"
}

{
  "id": "cr-003",
  "foreground_hex": "#1A1A2E",
  "background_hex": "#FFFFFF",
  "contrast_ratio": 14.73,
  "foreground_luminance": 0.011,
  "background_luminance": 1,
  "compliant_normal_text": true,
  "compliant_large_text": true,
  "wcag_level": "AAA",
  "context": "body-text",
  "created_at": "2026-03-26T10:00:00Z"
}

Update context or metadata on a saved contrast ratio result

{
  "context": "heading-large",
  "foreground_hex": "#1A1A2E",
  "background_hex": "#F5F5F5"
}

{
  "id": "cr-003",
  "foreground_hex": "#1A1A2E",
  "background_hex": "#F5F5F5",
  "contrast_ratio": 13.21,
  "foreground_luminance": 0.011,
  "background_luminance": 0.913,
  "compliant_normal_text": true,
  "compliant_large_text": true,
  "wcag_level": "AAA",
  "context": "heading-large",
  "created_at": "2026-03-26T10:00:00Z",
  "updated_at": "2026-03-26T10:05:00Z"
}

Delete a saved contrast ratio result

{
  "deleted": true,
  "id": "cr-003"
}

One-off contrast validation without persisting

{
  "foreground_hex": "#9E9E9E",
  "background_hex": "#FFFFFF",
  "text_role": "normal"
}

{
  "contrast_ratio": 3.95,
  "compliant": false,
  "wcag_level": "fail",
  "minimum_required": 4.5,
  "suggestion_foreground_hex": "#767676"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}