Resets · Developers

Free JSON API for Codex & Claude usage resets

The full history behind our reset tracker as JSON, for bots, dashboards, status lines and research. No key, no sign-up, no cookies. Any site may call it from the browser (CORS is open), and responses are cached for five minutes.

Endpoints

GET https://retroaitracker.com/api/public/resets/codex
GET https://retroaitracker.com/api/public/resets/claude

Both return the same shape. Only GET is supported; please keep polling to once every few minutes, since the data changes a few times a week at most.

Fields

provider: codex or claude
page: Our reset page for this provider (link here when you credit us)
license: CC BY 4.0, with the attribution text to show
generatedAt: When this response was built (UTC)
lastCompletedReset: The newest completed reset: at (UTC), basis, daysAgo (whole days), source (original post); null if none
counts: entries, resets (completed or reported), announced, banked and other
stats: days with a reset, first and last such day, last90, recent (days in the last 90), medianGapDays and longestGap
entries[]: Every entry, newest first: at (UTC), dayOnly (time unknown), label, title, scope, source and page

basis is reported when the original post itself said the reset was done, and confirmed when an announced reset was later confirmed in a separate post (then at is the confirmation time). Times without a known hour have dayOnly: true.

Entry labels

Completed: An original post says the reset is done, or a later post confirmed an announced reset.
Reset report: An original post reports that limits were reset, without a separate follow-up.
Announced: A reset was announced or planned but not reported as done. Never moves lastCompletedReset.
Banked reset: A reset you can redeem yourself (for example Claude's “Reset for free”). Logged, not counted.
Update: A reminder or other context, such as a redemption deadline.
Limit update: A change to the limits themselves rather than a reset.

Only Completed and Reset report entries count as resets. The rules are on how we verify.

Examples

Shell

curl -s https://retroaitracker.com/api/public/resets/codex | jq '.lastCompletedReset'

JavaScript

const res = await fetch("https://retroaitracker.com/api/public/resets/codex");
const { lastCompletedReset } = await res.json();
console.log(lastCompletedReset?.daysAgo);

License and credit

The data is free under CC BY 4.0, also commercially. Credit “Retro AI Tracker” with a link to the reset page given in page (how to cite). Each entry links to its original post; quoted posts belong to their authors.

We add fields without notice but do not rename or remove them without updating this page first. Version 1, 17 October 2026.

Feeds and badges

Prefer feeds? Reset RSS · Release RSS. For a README or website there is a live last-reset badge. Corrections: contact us with the original post.