Skip to main content
Changelogs

List all changelogs

Returns all changelogs for the authenticated organization.

GET
/v2/changelogs

Changelogs are release notes and updates that keep users informed about new features, improvements, and bug fixes. Each changelog can have:

  • Multiple translations (locales)
  • Categories for organization
  • Featured images
  • Scheduled publishing

Pagination

This endpoint uses cursor-based pagination:

  • limit - Number of changelogs to return (1-100, default 10)
  • cursor - Opaque cursor from a previous response's nextCursor field

Example: To paginate through results:

  1. First request: GET /v2/changelogs?limit=10
  2. If nextCursor is not null, use it for the next page
  3. Next request: GET /v2/changelogs?limit=10&cursor={nextCursor}

Response Format

Returns a list object with:

  • object - Always "list"
  • data - Array of changelog objects
  • nextCursor - Cursor for the next page (null if no more results)

Filtering

Filter changelogs using query parameters:

  • id - Find a specific changelog by ID or slug
  • q - Search query for title/content
  • categories - Filter by category names
  • locale - Get changelogs in a specific locale (defaults to org default)
  • state - Filter by state: live, draft, or all
  • startDate - Include changelogs dated on or after this date
  • endDate - Include changelogs dated on or before this date

Sorting

Results are sorted by date (descending by default):

  • sortBy - Field to sort by (currently only date)
  • sortOrder - Sort direction: asc or desc (default: desc)

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Query Parameters

idstringquery

Find changelog by its id (also accepts slug)

Example: 6457e3ff70afca5d8c27dccc
qstringquery

Search for changelogs by title or content

Maximum string length: 255
Example: new feature
categoriesstring | string[]query

Filter changelogs by category names (single value or array)

localeenum<string>query

The locale of the changelogs. Defaults to the organization default locale.

Available options: ar, am, fa, ht, lo, my, pa, ps, so, tl, ur, he, ta, te, mr, gu, kn, ml, ha, jv, yo, ig, uz, ne, sd, az, si, km, kk, bn, bs, pt-BR, bg, ca, hr, cs, da, nl, en, et, fi, fr, de, el, hi, hu, id, it, ja, ko, lv, lt, ms, mn, nb, pl, pt, ro, ru, sr, zh-CN, sk, sl, es, sw, sv, th, zh-TW, tr, uk, vi
Example: en
stateenum<string>querydefault:live

The state of the changelog. Use "all" to get both draft and live changelogs.

Available options: draft, live, all
Example: live
startDatestring | nullquery

Include Changelogs dated on or after the specified start date

Example: 2024-01-01
endDatestring | nullquery

Include Changelogs dated on or before the specified end date

Example: 2024-12-31
limitintegerquerydefault:10

Maximum number of changelogs to return

Required range: 1 <= x <= 100
Example: 10
cursorstringquery

Cursor for pagination. Use nextCursor from previous response.

Maximum string length: 512
Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
sortByenum<string>querydefault:date

Field to sort by

Available options: date
Example: date
sortOrderenum<string>querydefault:desc

Sort direction

Available options: asc, desc
Example: desc

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

dataobject[]required

Array of changelogs

nextCursorstring | nullrequired

Cursor for fetching the next page (cursor-based pagination)

Maximum string length: 512
Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
objectenum<string>required

Object type identifier

Available options: list
Example: list
paginationobject

Pagination metadata for page-based requests

Still need help? Ask the team