Querying entries

What is returned

Only published entries are delivered; drafts and entries scheduled for the future are not. Fields marked private and password fields are never included.

List entries

GET https://your-workspace.praismahub.com/api/v1/public/YOUR_TOKEN/ORG_ID/blog-posts?page=1&pageSize=20&sort=published_at:desc{ "data": [ { "id": "9b1f...", "type": "blog-posts", "status": "published", "lang": "en", "published_at": "2026-10-02T09:00:00Z", "created_at": "...", "updated_at": "...", "attributes": { "title": "Hello", "slug": "hello", "body": "<p>...</p>" }, "media": { "cover": [ { "id": "...", "url": "...", "thumbnail_url": "...", "alt_text": "...", "mime": "image/jpeg" } ] }, "relations": {}, "translations": [], "tags": [] } ], "meta": { "type": "blog-posts", "sort": ["published_at:desc", "id:desc"], "pagination": { "page": 1, "pageSize": 20, "pageCount": 3, "total": 47 } } }

Scalar values are under attributes, media fields under media.<field> (a list of files with ready-to-use URLs), and populated relations under relations.<field>. Rich text fields are returned as HTML.

Read one entry

Use the entry id or its slug:

GET https://your-workspace.praismahub.com/api/v1/public/YOUR_TOKEN/ORG_ID/blog-posts/hello

The answer is {"data": {...}, "meta": {"type": "blog-posts"}}, or a 404 with "data": null.

Query parameters

page(from 1) andpageSize(1 to 100, default 20).

fields: comma-separated field names to return, e.g.fields=title,slug.

populate: comma-separated relation paths to include, e.g.populate=author,category.parent.

depth: how deep relations are resolved (1 to 5, default 2).

lang: a locale code, e.g.lang=nl, to get entries in that language.

include[media],include[relations],include[translations],include[tags]: set tofalseto leave a part out (all default to true).

related_to=<entryId>&relation_field=<field>: list only entries linked to that entry through that relation field.

Search, filters and sorting are covered in Filtering, sorting and search.

Relation sub-queries

A populated relation can have its own filters, sort, paging and search:

?relations[comments][sort]=created_at:desc&relations[comments][page][size]=5

Overview of all collections

A GET on the base URL returns, for every collection the token may list, its type (id, slug, name) and its latest items. Use limit (1 to 50, default 5) to control how many.