/api — API, feeds & badges

$ Everything on this site is available as data. No API key, Access-Control-Allow-Origin: *, responses cached for 5 minutes. Build a Raycast command, a VS Code status bar item, a Slack bot, a Home Assistant sensor — and link back so people can find the history.

Fields are stable within /api/v1/; new fields may be added, existing ones are not removed. Timestamps are ISO-8601 UTC. Please poll no more often than every 5 minutes.

// ENDPOINTS

/api/v1/latest.json Latest event site-wide + per-provider last reset, days since, average gap. Poll this.

/api/v1/events.json?provider=openai&type=regular&since=2026-09-01&limit=50 Cross-provider event stream, newest first. All params optional.

/api/v1/{provider}.json?limit=20 One provider: metadata, stats, plans, upcoming rule change, events.

/feed.xml?lang=en RSS 2.0, last 50 events across providers. lang: en zh ja ko de fr es pt.

/{provider}/feed.xml RSS 2.0 for one provider.

/badge/{provider}.svg README badge: "codex reset · 3d ago". Green under the average gap, yellow above it, red past the longest gap on record.

/badge/{provider}.json Same data in shields.io endpoint format.

Providers: openaianthropicxaigooglekimiglmcursor

// EXAMPLE

$ curl -s https://whenaireset.com/api/v1/latest.json | jq '.providers.openai | {last_reset_at, days_since_reset, avg_gap_days}'
{
  "last_reset_at": "2026-09-12T08:09:17.000Z",
  "days_since_reset": 3.2,
  "avg_gap_days": 6.1
}

// README BADGE

![Codex reset](https://whenaireset.com/badge/openai.svg)
[![Claude Code reset](https://whenaireset.com/badge/anthropic.svg)](https://whenaireset.com/anthropic)

# or via shields.io, with its styling options
![Codex reset](https://img.shields.io/endpoint?url=https%3A%2F%2Fwhenaireset.com%2Fbadge%2Fopenai.json)

// CLI & MCP SERVER

whenaireset on npm wraps the same API: a terminal table, and an MCP server so Claude Code / Codex / Cursor can answer "when did Codex last reset?" from inside the session.

$ npx whenaireset            # all providers
$ npx whenaireset openai     # one provider, recent events
$ npx whenaireset mcp        # stdio MCP server

# Claude Code
$ claude mcp add whenaireset -- npx -y whenaireset mcp

# Codex (~/.codex/config.toml)
[mcp_servers.whenaireset]
command = "npx"
args = ["-y", "whenaireset", "mcp"]

Tools exposed: list_providers, latest_reset, reset_history. Source lives in the site repo under packages/whenaireset-cli.

// TERMS

Free for any use, attribution appreciated (a link to whenaireset.com). Data is compiled from public announcements and may lag or contain errors — every event carries its source_url, verify against it before acting on it. Not affiliated with any AI provider.