Skip to content

Commit fedb994

Browse files
espenclaude
andcommitted
Document restored pagination headers and Pagy 43 renames
Pagination headers were missing since 2025-11-28 and are restored. Pagy 43 renamed Page-Items to page-limit and the Link relation type prev to previous. Recommend paginating by following rel="next". Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BM8STHz8FqPYMPBFfu2VmN
1 parent 0e01be1 commit fedb994

2 files changed

Lines changed: 7 additions & 1 deletion

File tree

‎_guides/pagination.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: Pagination in the Makeplans API — page sizes, the page parameter
66

77
Maximum 100 items are returned per response for all endpoints except `bookings` which returns 750. Specify page with parameter `page`. Pagination is used for: bookings, events, orders and people. All other objects return all available items. Please note that currently there is no way to specify exact part of the dataset. Thus an item might appear in both page 2 and 3 if the complete dataset for the query has changed.
88

9-
[RFC 8288](https://datatracker.ietf.org/doc/html/rfc8288){:target="_blank"} is used for pagination linking. You will find URLs for first, prev, next and last pages in the `Link` HTTP Header. In addition metadata is added in the following HTTP Headers: `Current-Page`, `Page-Items`, `Total-Count`, `Total-Pages`.
9+
[RFC 8288](https://datatracker.ietf.org/doc/html/rfc8288){:target="_blank"} is used for pagination linking. The `Link` HTTP header contains URLs with the relation types `first`, `previous`, `next` and `last`. `previous` and `next` are omitted on the first and last page respectively, so you can paginate by following `next` until it is absent. In addition metadata is added in the following HTTP Headers: `current-page`, `page-limit`, `total-count`, `total-pages`.
1010

1111
## Example request and response
1212

‎changelog.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,12 @@ permalink: /changelog/
55
description: Changes and additions to the Makeplans API, newest first.
66
---
77

8+
## 2026-08-22
9+
10+
**Restored pagination metadata headers, renamed `Page-Items` to `page-limit`**
11+
12+
Due to a regression, paginated responses sent no pagination HTTP headers (including `Link`) since 2025-11-28. All headers are now restored with two changes: the `Page-Items` header is renamed to `page-limit`, and the `Link` relation type `prev` is renamed to `previous`. Header names are lowercase (`current-page`, `page-limit`, `total-count`, `total-pages`); as always, header names are case-insensitive. We recommend paginating by following the RFC 8288 `Link` header with `rel="next"` rather than using the metadata headers.
13+
814
## 2026-03-28
915

1016
**Added message templates endpoint**

0 commit comments

Comments
 (0)