Convert HEX colors to NCS and RAL color systems using the industry-standard Delta-E (CIEDE2000) color matching algorithm.

Getting Started

Want API access? Contact [email protected] to get your API token.

Try it without authentication

You can test the API without an API key using these demo colors:

• ff5733 (bright orange)
• 3498db (blue)

Example: GET /api/v2/convert/ncs?hex=ff5733

Authentication

Send your API key as a Bearer token in the Authorization header of every request:

GET /api/v2/convert/ncs?hex=ff5733
Authorization: Bearer YOUR_API_KEY

Call the API from your server, never from the browser, so the key stays private.

Every response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. Errors:

• 401 — the Authorization header is missing or malformed
• 403 — the API key is not valid
• 429 — the rate limit is exceeded

Note

Color matches are mathematical approximations for screen use. Always verify critical color decisions with physical color references (fan decks, swatches).