List Add-ons

Retrieve every add-on of a product you own, drafts included.

Endpoint

GET /api/v3/content/{content}/add-ons

{content} is the product's internal ID, or any of its identifiers with id_type=external.

---

Query Parameters

Product lookup

Parameter	Type	Default	Description
id_type	string	internal	internal (product ID) or external (identifier)

Pagination

Parameter	Type	Default	Description
per_page	integer	100	Items per page (1-500)
cursor	string	-	Cursor token from links.next or links.prev

Sorting

Parameter	Type	Default	Description
sort	string	start_page	Sort field. Prefix with - for descending

Allowed sort fields: start_page, created_at, updated_at

Filters

Parameter	Type	Description
filter[status]	string	draft or published
filter[type]	string	article, audio, video, image or link

Fields Selection

Parameter	Type	Description
fields	string	Comma-separated list of fields to return

---

Request Examples

# All add-ons of publication 123, in reading order
curl -X GET "https://yourstore.publica.la/api/v3/content/123/add-ons" \
  -H "X-User-Token: your-api-token"

# Only drafts, by external identifier
curl -X GET "https://yourstore.publica.la/api/v3/content/9789561234567/add-ons?id_type=external&filter[status]=draft" \
  -H "X-User-Token: your-api-token"

# Trimmed payload
curl -X GET "https://yourstore.publica.la/api/v3/content/123/add-ons?fields=id,title,status,start_page" \
  -H "X-User-Token: your-api-token"

Response

{
  "data": [
    {
      "id": "1044",
      "content_id": "123",
      "title": "Interview with the author",
      "pretitle": null,
      "author": null,
      "by_line": null,
      "type": "article",
      "body": "<p>…</p>",
      "body_format": "html",
      "image_url": null,
      "image_caption": null,
      "start_page": 3,
      "end_page": 3,
      "location_in_start_page": { "x": 25.5, "y": 40 },
      "anchor": { "type": "point", "page": 3, "point": { "x": 25.5, "y": 40 } },
      "status": "draft",
      "created_at": "2026-08-13T14:05:00.000000Z",
      "updated_at": "2026-08-13T14:05:00.000000Z"
    }
  ],
  "links": {
    "next": "https://yourstore.publica.la/api/v3/content/123/add-ons?cursor=eyJ...",
    "prev": null
  },
  "meta": {
    "has_more": true
  }
}

Owners see drafts

This endpoint returns add-ons in every status. Drafts are hidden from readers (web reader, apps, offline downloads), never from the owner managing them.

Errors

Status	Condition
401	Missing or invalid X-User-Token
403	Add-ons feature not enabled, non-administrator token, or the product is not owned by your store
404	Product not found
422	Invalid query parameter (unknown sort field, invalid filter value)