Show Ad Break
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"
import requests
import json
url = "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/ad-breaks/example_string"
headers = {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.5centscdn.com/v2/streams/pull/123/adinsertion/ad-breaks/example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/ad-breaks/example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.5centscdn.com/v2/streams/pull/123/adinsertion/ad-breaks/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"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
RequiredAPI key (sent in header)
path
streamidinteger
RequiredNumeric stream ID.
path
adbreakidstring
RequiredID of the ad break.
Request Preview
Response
Response will appear here after sending the request
Authentication
header
X-API-Keystring
RequiredAPI Key for authentication. Provide your API key in the header.
Path Parameters
streamidinteger
RequiredNumeric stream ID.
adbreakidstring
RequiredID of the ad break.
Responses
idstring
serviceIdinteger
sessionIdstring
contentIdstring
breakTypestring
Allowed values:
pre-rollmid-rolltriggerTypestring
SCTE-35 splice command type or preroll that started this break.
declaredDurationSnumber
vastOutcomestring
Allowed values:
oktimeouthttp_4xxhttp_5xxnetworkparseno_creativewrapper_exceededvastUrlstring
creativeCountinteger
fulfilledDurationSnumber
fillStatusstring
Allowed values:
fullunderfilledno_fillcreatedAtstring
resultstring
Allowed values:
successerrormessagestring
creativesarray
Was this page helpful?