---
title: "Get source changelog"
method: GET
path: "/orgs/{orgSlug}/sources/{sourceSlug}/changelog"
tags: ["Sources"]
---

# Get source changelog

`GET /orgs/{orgSlug}/sources/{sourceSlug}/changelog`

## Request

- Base URL: `https://api.releases.sh`
- URL: `https://api.releases.sh/orgs/{orgSlug}/sources/{sourceSlug}/changelog`
- Auth: one of:
  - none
  - HTTP bearer

Returns the source's tracked CHANGELOG.md (or the file selected by `?path=`), sliced by characters (`?offset=`, `?limit=`) or by a cl100k_base token budget (`?tokens=`). Page with `nextOffset`. Always includes the full `files` index so clients can render a file picker.

## Path parameters

- `orgSlug` string, required
- `sourceSlug` string, required

## Query parameters

- `path` string
- `offset` integer
- `limit` integer
- `tokens` integer

## Response `200`

Changelog slice with file index

- object
  - `path` string, required
  - `filename` string, required
  - `url` string, required
  - `rawUrl` string, required
  - `content` string, required
  - `bytes` integer, required
  - `fetchedAt` string, required
  - `offset` integer, required
  - `limit` integer, required
  - `nextOffset` integer, nullable, required
  - `totalChars` integer, required
  - `tokens` integer
  - `sliceTokens` integer
  - `totalTokens` integer, required
  - `truncated` boolean, required
  - `truncatedAt` integer, nullable, required
  - `files` object[], required
    - `path` string, required
    - `filename` string, required
    - `url` string, required
    - `bytes` integer, required
    - `fetchedAt` string, required

## Other responses

- `404`: Source or changelog file not found

## Changes

- **2026-10-25** `d2dc9b39f6c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/releases/apis/releases-api/changes/orgs/:orgSlug/sources/:sourceSlug/changelog/get.md)

---

[API](https://skmtc.dev/releases/apis/releases-api.md) - [All operations](https://skmtc.dev/releases/apis/releases-api/llms.txt) - [OpenAPI document](https://skmtc.dev/releases/apis/releases-api/revisions/d2dc9b39f6c3?raw)
