API Reference
Pagination
Cursor-based pagination for list endpoints across the Meridian API.
Quick start
GET /v1/recipes?limit=20&cursor=eyJpZCI6IjQyIn0Every list endpoint accepts limit and cursor query parameters.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| limit | integer | 20 | Max items per page (1–100) |
| cursor | string | null | Opaque base64 cursor from previous response |
Response shape
{
"data": [ ... ],
"pagination": {
"next_cursor": "eyJpZCI6IjYyIn0",
"has_more": true
}
}- next_cursor — pass as ?cursor= for the next page
- has_more — false when you have reached the final page
Edge cases
Empty cursor → first page. Omit the parameter entirely.
Invalid cursor → 400 Bad Request with a descriptive error.
limit > 100 → clamped to 100 silently.