Collections

Entries of a collection (blog, news, case studies…), paginated.

Base URL, authentication and conventions of this API are on the Content Delivery API page.

Endpoints

get/collections/{collection}/entriesList published entries of a collection
get/collections/{collection}/entries/{entry}Get a published entry by slug

get/collections/{collection}/entries

List published entries of a collection

Entries that have a published translation in the locale, newest first (by publish date, then id). Standard pagination: data plus current_page, last_page, per_page, total, links and the page URLs. Unknown collection → 404.

GET https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/{collection}/entries

Authentication: Bearer token

Rate limit: 120 requests per 1m, per IP

Path parameters

collectionstringrequired
Collection slug.

Example: blog

Query parameters

localestring
Locale code enabled on the site. Default the site's default locale.

Example: en
pageinteger
min 1default 1
Example: 1
per_pageinteger
Clamped to 1–50.

min 1max 50default 12
Example: 12

Responses

200A page of entries.application/json
- current_pageinteger
- dataarray of Entry & object
  Attributes of each item
  idinteger
  titlestring
  slugstring
  fieldsobject | null
  Collection-defined fields.
  
  seoobject | null
  published_atstring (date-time) | null
  sortinteger
- first_page_urlstring (uri)
- frominteger | null
- last_pageinteger
- last_page_urlstring (uri)
- linksarray of object
- next_page_urlstring (uri) | null
- pathstring (uri)
- per_pageinteger
- prev_page_urlstring (uri) | null
- tointeger | null
- totalinteger
401Missing or unknown delivery token.application/json
- messagestring
404Not found. Also returned when the workspace slug is unknown or when the token belongs to another site (Nucleo never confirms that a site exists to a token that cannot read it). The text of message varies with the case: branch on the 404 status only. application/json
- messagestring
429More than 120 requests in a minute from the same IP.application/json
Headers
- Retry-After
- X-RateLimit-Limit
- X-RateLimit-Remaining
- messagestring

Request

curl -X GET 'https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?locale=en&page=1&per_page=12' \
  -H "Authorization: Bearer $NUCLEO_CMS_TOKEN" \
  -H 'Accept: application/json'

const res = await fetch("https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?locale=en&page=1&per_page=12", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NUCLEO_CMS_TOKEN}`,
    Accept: "application/json",
  },
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?locale=en&page=1&per_page=12', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('NUCLEO_CMS_TOKEN'),
        'Accept' => 'application/json',
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

Response

{
  "current_page": 1,
  "data": [
    {
      "id": 501,
      "sort": 0,
      "title": "Autumn drop is live",
      "slug": "autumn-drop",
      "fields": {
        "excerpt": "Ten new tees in organic cotton.",
        "cover_media_id": 340
      },
      "seo": {
        "title": "Autumn drop · Acme Apparel"
      },
      "published_at": "2026-09-28T08:00:00.000000Z"
    }
  ],
  "first_page_url": "https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?page=1",
  "from": 1,
  "last_page": 4,
  "last_page_url": "https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?page=4",
  "links": [],
  "next_page_url": "https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries?page=2",
  "path": "https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/blog/entries",
  "per_page": 12,
  "prev_page_url": null,
  "to": 12,
  "total": 41
}

{
  "message": "Delivery token required (Authorization: Bearer)."
}

{
  "message": "Invalid delivery token."
}

{
  "message": "Not found."
}

{
  "message": "Too Many Attempts."
}

get/collections/{collection}/entries/{entry}

Get a published entry by slug

One entry by its translated slug in the locale; 404 if it does not exist or is not published in that locale.

GET https://api-brain.nucleoplatform.com/api/delivery/v1/acme/sites/12/collections/{collection}/entries/{entry}