Lodestone API
JSON API for FFXIV Lodestone data.
Endpoints
click a row to load it into Try it| Method | Path | Description |
|---|---|---|
| GET | /v1/character/search/{world}/{name} | Search characters by name on a world |
| GET | /v1/character/{id} | Profile + class jobs + cached gearsets |
| GET | /v1/character/{id}/achievements | Character achievements |
| GET | /v1/character/{id}/mounts | Character mounts |
| GET | /v1/character/{id}/minions | Character minions |
| GET | /v1/freecompany/search/{world}/{name} | Search free companies |
| GET | /v1/freecompany/{id} | Free company details |
| GET | /v1/freecompany/{id}/members | Free company members |
Try it
select an endpoint aboveCache contract
All data routes require a revalidate-after Unix-seconds query param. Responses with updatedAt < revalidate-after are treated as a cache miss and refetched. Other query params are ignored.
Past per-data-type stale thresholds (profile/achievements 6h, collections 24h), responses are still served from cache but a background refresh is enqueued.
Per-IP rate limit: 100 requests / 60s. Exceeding triggers a 429 with Retry-After: 60; for ID-bearing routes, the character is also enqueued for a background refresh so the next caller likely sees fresh data.