API Documentation

ReleaseRun provides free REST APIs for software version lifecycle and end-of-life data covering 430+ products. No API key required. CORS enabled for all origins.

Quick start
curl https://releaserun.com/hub-api/v1/python/versions/

Base URLs

Hub API https://releaserun.com/hub-api/v1/
Badge Service https://releaserun.com/badge/

Hub API Endpoints

GET /{product}/versions/

Returns all versions for a product with lifecycle dates.

curl https://releaserun.com/hub-api/v1/python/versions/
Response
{
  "versions": [
    {
      "minor_version": "3.14",
      "latest_patch": "3.14.3",
      "release_date": "2025-10-07",
      "eol_date": "2030-10-31",
      "support_end_date": "2027-10-01",
      "is_lts": false,
      "changelog_url": null,
      "latest_release_date": "2026-02-03"
    }
  ],
  "count": 17
}

GET /{product}/versions/{version}

Returns lifecycle data for a specific version.

curl https://releaserun.com/hub-api/v1/python/versions/3.13
Response
{
  "minor_version": "3.13",
  "latest_patch": "3.13.12",
  "release_date": "2024-10-07",
  "eol_date": "2029-10-31",
  "support_end_date": "2026-10-01",
  "is_lts": false,
  "changelog_url": null,
  "latest_release_date": "2026-02-03"
}

GET /{product}/stats/

Returns summary statistics for a product.

curl https://releaserun.com/hub-api/v1/python/stats/
Response
{
  "total_versions": 17,
  "supported_versions": 5,
  "latest_version": "3.14.3",
  "last_updated": "2026-02-21T09:11:00.187368+00:00"
}

Badge Endpoints (SVG)

Embeddable SVG badges for READMEs, dashboards, and documentation.

Version Badge

https://releaserun.com/badge/python/version.svg

Python version badge

EOL Status Badge

https://releaserun.com/badge/python/eol.svg

Python EOL badge

CVE Badge

https://releaserun.com/badge/python/cve.svg

Python CVE badge

Health Badge

https://releaserun.com/badge/python/health.svg

Python health badge

Cloud Support Badge

https://releaserun.com/badge/python/cloud.svg

Python cloud badge

Shields.io JSON Endpoint

Use with Shields.io endpoint badges:

https://img.shields.io/endpoint?url=https://releaserun.com/badge/python/shields.json

Badge Customization

Append query parameters to any badge URL:

Parameter Values Example
style flat, flat-square, plastic, for-the-badge ?style=for-the-badge
label Custom left-side text ?label=Python+Latest
color Hex color or named color ?color=blue
logo Simple Icons slug ?logo=python

Example:

https://releaserun.com/badge/python/version.svg?style=for-the-badge&logo=python

Customized badge


Product Slugs

Use any product slug from endoflife.date’s product list (430+ products). Common examples:

Product Slug Example
Python python /hub-api/v1/python/versions/
Node.js nodejs /hub-api/v1/nodejs/versions/
PostgreSQL postgresql /hub-api/v1/postgresql/versions/
Kubernetes kubernetes /hub-api/v1/kubernetes/versions/
Ubuntu ubuntu /hub-api/v1/ubuntu/versions/
Docker Engine docker-engine /hub-api/v1/docker-engine/versions/
Go go /hub-api/v1/go/versions/
React react /hub-api/v1/react/versions/

Response Fields

Field Type Description
minor_version string Major.minor version identifier
latest_patch string Latest patch release version
release_date string Initial release date (YYYY-MM-DD)
eol_date string|null End-of-life date
support_end_date string|null Active support end date
is_lts boolean Whether this is a long-term support release
changelog_url string|null Link to the changelog
latest_release_date string Date of the latest patch release

Rate Limits

Hub API 200 requests/minute per IP
Badge Service 100 requests/minute per IP

Exceeding the limit returns HTTP 429. Responses include standard rate-limit headers.


Caching

Hub API responses include Cache-Control headers. Data is refreshed from upstream sources every 6 hours. For badges embedded in READMEs, GitHub and CDNs cache SVGs — expect up to 24-hour propagation for updates.


Error Responses

Code Meaning
200 Success
404 Product or version not found
429 Rate limit exceeded
500 Internal server error

Error responses return JSON:

{"detail": "Product 'foo' not found"}

JavaScript Example

// Fetch Python version data (works from any origin — CORS enabled)
const res = await fetch('https://releaserun.com/hub-api/v1/python/versions/');
const data = await res.json();
console.log(`Latest Python: ${data.versions[0].latest_patch}`);
// → "Latest Python: 3.14.3"

Founded

2023 in London, UK

Contact

hello@releaserun.com