---
title: "List the latest posterly product updates"
method: GET
path: "/api/v1/updates"
tags: ["Updates"]
---

# List the latest posterly product updates

`GET /api/v1/updates`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/updates`
- Auth: HTTP bearer

Returns the posterly updates feed (product news: new features, improvements, and fixes), newest first. Requires an active posterly subscription; without one the endpoint returns 403 with code `subscription_required`.

## Query parameters

- `limit` integer
- `offset` integer
- `since` string, date
- `include_content` boolean

## Response `200`

Updates fetched successfully

- UpdatesResponse
  - `updates` object[], required
    - `slug` string, required
    - `title` string, required
    - `date` string, date, required
    - `version` string, required
    - `summary` string, required
    - `type` 'feature' | 'improvement' | 'fix' | 'null', nullable, required
    - `areas` string[], required
    - `url` string, uri, required
    - `image` string
    - `video` string
    - `content` string: Full markdown body. Only present when include_content=true.
  - `total` integer: Exact number of updates matching since, across all pages.
  - `limit` integer
  - `offset` integer
  - `has_more` boolean: True when more items exist after this page. Keep paging until it is false.
  - `next_offset` integer, nullable: The offset of the next page, or null on the last page.

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `403`: Request is authenticated but not allowed
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)