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.
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
EOL Status Badge
https://releaserun.com/badge/python/eol.svg
CVE Badge
https://releaserun.com/badge/python/cve.svg
Health Badge
https://releaserun.com/badge/python/health.svg
Cloud Support Badge
https://releaserun.com/badge/python/cloud.svg
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
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