Skip to main content
GET https://cds.thepublive.com/publisher/{publisher_id}/active-slots/ Returns the configured advertisement slots for your publication, including slot dimensions, content, and type.

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret

​
Response Fields

Each slot contains:
FieldTypeDescription
idintegerUnique slot identifier
namestringSlot name
dataobjectSlot configuration (size, HTML content, contains_ads flag)
registered_slotobjectRegistered slot metadata
formatted_update_onstringLast updated timestamp
typestringSlot type: Image, CodeEditor, or Editor
{
  "status": "ok",
  "data": [
    {
      "id": 1,
      "name": "Header Banner",
      "data": {
        "size": "728x90",
        "html": "<div class=\"ad-slot\">...</div>",
        "contains_ads": true
      },
      "registered_slot": {
        "id": 10,
        "name": "header_banner"
      },
      "formatted_update_on": "2026-02-01T10:00:00Z",
      "type": "CodeEditor"
    }
  ],
  "message": ""
}