API reference

Embed your latest releases in your app, docs site or marketing page. One endpoint, no auth.

Endpoint

GET /api/v1/{org}/releases/

Path parameters

org
string required

Your organisation slug, as shown in your dashboard and public changelog URLs.

Query parameters

project
string optional

Project slug. When set, only releases from that project are returned. Omit it to fetch across every project in the org.

limit
integer optional

Number of releases to return. Default 1, max 20. Values outside the range are clamped.

Response

Returns an object with a releases array. Each element has these fields:

title

stringRelease title, written by AI from the grouped changes.

headline

stringShort one-line summary. May be empty.

summary

stringLonger description. May be empty.

project

stringHuman-readable project name.

published

stringISO 8601 timestamp of when the release was published.

url

stringPath to the public changelog page for this release's org or project.

changes_count

integerNumber of published changes in this release.

Examples

curl shell 
# Latest release for an org
curl https://releasetape.com/api/v1/acme/releases/

# Last 3 releases from a specific project
curl "https://releasetape.com/api/v1/acme/releases/?project=web-app&limit=3"
JavaScript js 
const getLatestReleases = async ({ org, project, limit = 1 }) => {
  const params = new URLSearchParams({ limit });
  if (project) params.set("project", project);

  const res = await fetch(
    `https://releasetape.com/api/v1/${org}/releases/?${params}`
  );
  const { releases } = await res.json();
  return releases;
};

// Usage
const releases = await getLatestReleases({
  org: "acme",
  project: "web-app",
  limit: 3,
});

releases.forEach(release => {
  console.log(release.title, release.published);
});
Response json 
{
  "releases": [
    {
      "title":         "Search, notifications and performance",
      "headline":      "Full-text search, real-time notifications and faster page loads",
      "summary":       "This release focuses on discoverability and responsiveness across the app.",
      "project":       "Web App",
      "published":     "2026-03-26T14:32:00+00:00",
      "url":           "/acme/web-app/",
      "changes_count": 4
    },
    {
      "title":         "Dark mode and UI polish",
      "headline":      "System-aware dark mode and refined component styling",
      "summary":       "",
      "project":       "Web App",
      "published":     "2026-03-19T09:15:00+00:00",
      "url":           "/acme/web-app/",
      "changes_count": 2
    }
  ]
}

Notes