ArtificialWatch Retirements API

Dated model shutdowns from the labs' own deprecation pages

GitHub OpenAPI

Operations 3

GET /data/model-retirements.json AI model retirement calendar #
GET /data/model-retirements.csv AI model retirement calendar (CSV) #
GET /data/model-retirements.ics AI model shutdown calendar #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/artificialwatch:artificialwatch-retirements-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

artificialwatch-retirements-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ArtificialWatch open data Retirements API
  version: 1.0.0
  summary: AI model releases and shutdowns, first-party LLM API prices, published knowledge cutoffs, open-weights models, OpenCode's stealth models and leaderboard indexes as static JSON, CSV and iCalendar files.
  description: 'Read-only, keyless, CORS-open files at stable URLs: the AI model release log (dated by the day each model went live on a public API), each live model''s list price on its maker''s own API, the composite Bench and Coding indexes across public leaderboards, first-seen versus announcement times, every dated model shutdown from the labs'' own deprecation pages, the knowledge cutoff each lab publishes for its live models, every open-weights model with its Hugging Face repo, licence, size and rank, and every anonymous model OpenCode has listed with the lab that later claimed it. Files refresh with the site (about every 4 hours). Licence CC BY 4.0: credit ArtificialWatch with a link to the page named in each file''s `url`. Each board''s raw scores belong to that board.'
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
  contact:
    name: ArtificialWatch
    url: https://artificialwatch.com/data
servers:
- url: https://artificialwatch.com
security: []
tags:
- name: retirements
  description: Dated model shutdowns from the labs' own deprecation pages
paths:
  /data/model-retirements.json:
    get:
      operationId: getModelRetirements
      summary: AI model retirement calendar
      description: Every dated model shutdown OpenAI, Anthropic and Google list on their deprecation pages, past and scheduled, oldest first, each with the lab's recommended replacement and the page it came from. earliest marks a date the lab gives as the earliest possible one.
      tags:
      - retirements
      responses:
        '200':
          description: The retirement calendar
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Retirements'
  /data/model-retirements.csv:
    get:
      operationId: getModelRetirementsCsv
      summary: AI model retirement calendar (CSV)
      description: 'The retirement calendar as CSV: lab, model, ids (space-separated), shutdown, earliest, status, replacement, note, source.'
      tags:
      - retirements
      responses:
        '200':
          description: CSV with a header row
          content:
            text/csv:
              schema:
                type: string
  /data/model-retirements.ics:
    get:
      operationId: getModelRetirementsCalendar
      summary: AI model shutdown calendar
      description: 'Scheduled and recent shutdowns as an RFC 5545 calendar: one all-day event per shutdown. Subscribe with webcal://artificialwatch.com/data/model-retirements.ics.'
      tags:
      - retirements
      responses:
        '200':
          description: iCalendar
          content:
            text/calendar:
              schema:
                type: string
components:
  schemas:
    Retirements:
      type: object
      required:
      - name
      - url
      - license
      - generated
      - sources
      - count
      - scheduled
      - retirements
      properties:
        name:
          type: string
        url:
          type: string
          format: uri
        license:
          type: string
          format: uri
        attribution:
          type: string
        method:
          type: string
        generated:
          type: string
          format: date
        sources:
          type: array
          items:
            type: object
            required:
            - lab
            - url
            properties:
              lab:
                type: string
              url:
                type: string
                format: uri
              checked:
                type:
                - string
                - 'null'
        count:
          type: integer
        scheduled:
          type: integer
        retirements:
          type: array
          items:
            $ref: '#/components/schemas/Retirement'
    Retirement:
      type: object
      required:
      - lab
      - model
      - ids
      - shutdown
      - earliest
      - status
      - replacement
      - note
      - source
      properties:
        lab:
          type: string
        model:
          type: string
          description: The model (or endpoint) as the lab's page names it
        ids:
          type: array
          items:
            type: string
          description: API ids the row covers, dated snapshots included
        shutdown:
          type: string
          format: date
        earliest:
          type: boolean
          description: The lab gives this as the earliest possible date, not a fixed one
        status:
          type: string
          enum:
          - scheduled
          - retired
        replacement:
          type:
          - string
          - 'null'
          description: The lab's recommended replacement
        note:
          type:
          - string
          - 'null'
        source:
          type: string
          format: uri
          description: The lab's deprecation page
externalDocs:
  description: The open data page
  url: https://artificialwatch.com/data