{
  "vertical": "pigments",
  "title": "Pigments — the colours of art history, dated and cited",
  "essence": "What each colour is, when it first appears, and when it could not yet exist. A dating tool that argues only against a claim, never for it. No keys, no database, no funds, no take-rate.",
  "disclosure": {
    "informational_only": true,
    "authentication_advice": false,
    "not_authentication": "A pigment that postdates the claimed date is strong evidence AGAINST authenticity; a period-consistent palette can NEVER prove authenticity. Real pigment identification needs lab analysis (XRF/Raman/cross-section); this endpoint only reasons over pigments you supply, using first-attested dates that themselves carry uncertainty.",
    "note": "Reference facts over cited pigment histories. Every dated milestone and story carries source_url plus a truth_status (verified | source-declared | contested | unverified); descriptive fields are syntheses from each pigment’s cited sources list. Confirm against the primary source and real analysis before drawing a conclusion."
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/pigments",
      "desc": "This directory"
    },
    {
      "method": "GET",
      "path": "/api/pigments (list)",
      "desc": "Paginated pigment list with filters",
      "params": "limit, offset, family, type, era, hazard, marker, q"
    },
    {
      "method": "GET",
      "path": "/api/pigments/:id",
      "desc": "One full pigment record, e.g. /api/pigments/prussian-blue"
    },
    {
      "method": "GET",
      "path": "/api/pigments/random",
      "desc": "One random pigment, full record"
    },
    {
      "method": "GET",
      "path": "/api/pigments/families",
      "desc": "Colour families with member counts and ids"
    },
    {
      "method": "GET",
      "path": "/api/pigments/vocab",
      "desc": "The vocabularies: families, types, eras, hazard levels, truth statuses"
    },
    {
      "method": "GET",
      "path": "/api/pigments/anachronism",
      "desc": "Compare supplied pigments to a claimed date — anachronism / plausible / uncertain, per pigment, with the cited floor. Informational only; never proves authenticity.",
      "params": "pigments (comma-separated ids), claimed_date (year)"
    }
  ]
}