Get a package or repository changelog
Read release notes for a package or repository, ordered newest first. Retrieve recent releases to catch up on changes, or a version range to review everything between two releases.
Use this endpoint to understand what changed before updating a dependency. You can request just the release timeline or include the full release-note text.
Selector catalogue
Use the following selectors with the fields query parameter to choose which fields the response includes. See Choose what the response includes for details.
| Selector | Data | Default |
|---|---|---|
statements | Parsed statement page and release totals; no classification work. Timeline metadata remains required. | No |
statements.classification | Available classifications with uncertainty/provenance; implies statement items and assessment coverage. Missing answers are null; waits are bounded. | No |
statements.full_text | Uncut returned quotes and retained predecessor context; implies items independently of classification and raw release bodies. | No |
statements.coverage | Assessment coverage and page metadata without item text; does not imply items. Reduces payload, not classification work. | No |
entries | Complete timeline metadata: version, normalized_version, published_at and html_url when available. | Yes |
entries.body | Third-party Markdown bodies; implies the complete entries metadata group. | Yes |
entries.* | Explicit union of entries and entries.body. | No |
Parsed statements are opt-in and require package addressing. statements returns parsed quotes and release totals without requesting labels. statements.classification includes available labels and assessment coverage; selected unavailable labels are null. statements.coverage requests coverage without item text. statements.full_text returns uncut quotes and predecessor context independently of raw release bodies or labels. Timeline metadata remains required. Explicit fields replaces defaults; defaults and entries.* do not include statements.
Page controls are computation inputs, separate from fields. Active tiers request labels and imply assessment coverage, including with coverage-only selection; unassessed statements do not match. Zero matches with incomplete coverage do not prove absence of actionable changes. Coverage-only reduces payload, not assessment work. Waiting is bounded, so answers can remain unavailable. Read every page to exhaust matching parsed bullets; complete text only means uncut returned quotes. Offsets address current notes/labels without a snapshot guarantee. Compare available coverage, versions and source URLs and restart at offset zero if they change; unchanged counts/URLs cannot detect every wording change.
GET /v1/changelog?registry=npm&name=express HTTP/1.1
Host: api.githits.dev
Authorization: Bearer <token>{
"entries": [
{
"body": "## Changes\nBug fixes.",
"html_url": "https://github.com/expressjs/express/releases/tag/5.2.1",
"normalized_version": "5.2.1",
"published_at": "2026-01-15T12:00:00Z",
"version": "5.2.1"
}
],
"mode": "latest",
"package": {
"limit": 10,
"name": "express",
"registry": "npm",
"to_version": "5.2.1"
},
"source": "releases"
}Authorizations
Headers
Optional caller-defined session ID: one to 64 ASCII letters, digits, underscores or hyphens, preserved exactly. Supply the header at most once. Invalid supplied IDs return 400 INVALID_SESSION_ID; no session is created.
1 - 64^[A-Za-z0-9_-]{1,64}$Query Parameters
Normalized lower range bound, exclusive for released versions; enables complete-range mode and forbids limit. With from_version=1.0.0&to_version=1.2.0, releases are newer than 1.0.0 through 1.2.0 inclusive. Blank is absent; Go numeric versions gain lowercase v and existing lowercase v is accepted (uppercase V is rejected), Swift and Packagist allow native v/V tags, other modes reject numeric v/V-prefixed tags. Special unreleased entries follow source-specific handling.
Optional normalized upper bound, inclusive for released versions; special unreleased entries follow source-specific handling. In package mode, omission uses the package default for reads (native install default, then the registry's reported latest version, then stable/latest inventory); explicit latest uses the registry's reported latest version. Repository mode remains uncapped. Alone this keeps latest-count mode.
Finite response groups: entries, entries.body, entries.*, statements, statements.classification, statements.full_text, statements.coverage. Defaults to entries,entries.body. Explicit selection replaces defaults; entries.body includes entry metadata. Select entries alone for a timeline without release-note bodies. This reduces transfer size, but the changelog is still retrieved.
Use the case-sensitive selectors in the catalogue. Order and duplicate selectors do not affect the result. ASCII whitespace around selectors is ignored. The decoded value is limited to 2048 UTF-8 bytes. Empty or unknown selectors and repeated fields query parameters return 400 VALIDATION_ERROR. A group does not include nested groups unless the catalogue says so; only listed wildcard bundles are supported.
Comma-separated must_act, should_know, no_impact, unclassified. Omit for all parsed statements including unassessed. Active filters request labels, apply before paging and imply assessment coverage; allowed with coverage-only. Requires a statement selector. Empty or unknown tokens fail validation.
Response
Available changelog entries, newest first
Latest or range release timeline with optional paged parsed statements.
GET /v1/changelog?registry=npm&name=express HTTP/1.1
Host: api.githits.dev
Authorization: Bearer <token>{
"entries": [
{
"body": "## Changes\nBug fixes.",
"html_url": "https://github.com/expressjs/express/releases/tag/5.2.1",
"normalized_version": "5.2.1",
"published_at": "2026-01-15T12:00:00Z",
"version": "5.2.1"
}
],
"mode": "latest",
"package": {
"limit": 10,
"name": "express",
"registry": "npm",
"to_version": "5.2.1"
},
"source": "releases"
}