Ad InsertionShow Ad Break

Show Ad Break

Custom Plan Returns full detail for a single ad break, including its filled creatives and their tracking event timelines. Requires the Advanced Analytics add-on.

curl -X GET "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/ad-breaks/example_string" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "id": "brk_7e21c9",
  "serviceId": 10001,
  "sessionId": "sess_4a1b2c",
  "contentId": "1024",
  "breakType": "mid-roll",
  "triggerType": "splice_insert",
  "declaredDurationS": 30,
  "vastOutcome": "ok",
  "vastUrl": "https://adserver.example.com/vast.php?...",
  "creativeCount": 2,
  "fulfilledDurationS": 28,
  "fillStatus": "full",
  "createdAt": "2026-01-15T10:30:00Z",
  "result": "success",
  "message": "example_string",
  "creatives": [
    {
      "sequence": 1,
      "crid": "creative-abc123",
      "isGapFiller": false,
      "durationS": 15,
      "metadata": {
        "adTitle": "Summer Promo 2026",
        "advertiser": "Acme Corp",
        "adSystem": "Google Ad Manager",
        "category": "3"
      },
      "events": [
        {
          "eventType": "start",
          "createdAt": "2026-01-15T10:30:05Z"
        }
      ]
    }
  ]
}
GET
/streams/pull/{streamid}/adinsertion/ad-breaks/{adbreakid}
GET
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

path
streamidinteger
Required

Numeric stream ID.

path
adbreakidstring
Required

ID of the ad break.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

streamidinteger
Required

Numeric stream ID.

adbreakidstring
Required

ID of the ad break.

Responses

idstring
serviceIdinteger
sessionIdstring
contentIdstring
breakTypestring
Allowed values:pre-rollmid-roll
triggerTypestring

SCTE-35 splice command type or preroll that started this break.

declaredDurationSnumber
vastOutcomestring
Allowed values:oktimeouthttp_4xxhttp_5xxnetworkparseno_creativewrapper_exceeded
vastUrlstring
creativeCountinteger
fulfilledDurationSnumber
fillStatusstring
Allowed values:fullunderfilledno_fill
createdAtstring
resultstring
Allowed values:successerror
messagestring
creativesarray