API Reference
Base URL: https://data.xivdyetools.app/v1
All responses use the { success, data, meta } envelope. See Responses for the full spec.
Phase 1 Endpoints
| Method | Path | Description |
|---|---|---|
GET | /v1/dyes | List all dyes with filtering and sorting |
GET | /v1/dyes/:id | Lookup by itemID, stainID, or Facewear ID |
GET | /v1/dyes/stain/:stainId | Lookup by stainID (explicit) |
GET | /v1/dyes/search | Search dyes by name |
GET | /v1/dyes/categories | List categories with dye counts |
GET | /v1/dyes/batch | Multi-ID lookup (up to 50) |
GET | /v1/dyes/consolidation-groups | Patch 7.5 consolidation metadata |
GET | /v1/match/closest | Find closest dye to a hex color |
GET | /v1/match/within-distance | Find dyes within a distance threshold |
Health
bash
curl https://data.xivdyetools.app/healthReturns { "status": "ok", "timestamp": "..." } — no envelope, no auth, no rate limiting.