Get Harmonies

Archive-grounded colour harmonies in LCh perceptual colour space.

For each harmony type, rotates the input hue in LCh space, then finds the nearest named archive colour to each harmony target using CIEDE2000.

Returns named archive colours as harmonic partners -- with provenance, cultural context, and source -- not just hex codes.

"hay_contrast" is a different kind of harmony type from the rest: not a fixed-angle rotation, but D.R. Hay's (1838) documented contrast pairing between six named hues, snapped from the input's nearest hue rather than rotated from it, and returning Field's proportional power for the pair (attributed to Field, not Hay, throughout) alongside the CIEDE2000 archive match. Declines to answer (covered: false) rather than guess for a hue nearer a tertiary region than any of the six -- Hay's data has no specific number for those.

Example: {"hex": "#1B1556"}

Returns complementary, analogous, triadic, and split-complementary archive colours for Iago Venom (Shakespeare, Othello II.3.347).

post/harmonies

Request

  • Base URL: https://api.colourmemory.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.colourmemory.com/harmonies
  • Auth: none declared

Headers

x-api-keystring nullable
originstring nullable

Request body

hexstring required
typesstring[]
n_per_harmonyinteger

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.