Channels

Get a channel

GET
/v1/channels/{id}

Identity, timezone, dayparts, horizon, scope, ad configuration (adConfig), filler sources and distributors.

Scope: channels:read

Authorization

apiKey
headerAuthorizationBearer <ik_live_…>

An organisation API key from Settings → Organisation → API keys. Each operation names the one scope it needs — see https://developer.ingenee.ai/docs/authentication.

Path Parameters

id*string

Response Body

OK

application/json
  1. response
[key: string]?any
Example Request
curl -X GET 'https://dev.app.ingenee.ai/api/v1/channels/string'
Example Response
{  "channel": {    "posterSpec": {      "kind": "single",      "poster": "https://image.tmdb.org/t/p/w500/iiZZdoQBEYBv6id8su7ImL0oCbD.jpg",      "title": "Spider-Man: Into the Spider-Verse"    },    "adBreaks": {      "hasPublished": true,      "breaks": 590,      "minSec": 30,      "maxSec": 90,      "reviddLinked": false,      "campaigns": [],      "chain": {        "channelId": "1dad8739-b86a-4f5e-ab64-28b7f72a717d",        "name": "E2E Ad Channel India",        "tz": "Asia/Kolkata",        "status": "ok",        "excludedReason": null,        "window": {          "from": "2026-10-30",          "through": "2026-11-05",          "days": 6.389,          "fullDays": [            "2026-10-31",            "2026-11-01"          ]        },        "breaks": {          "perDay": 92,          "min": 45,          "max": 102        },        "breakSec": 90,        "breakSecMin": 30,        "breakSecMax": 90,        "slots": {          "perDay": 257,          "min": 126,          "max": 285        },        "spotSec": 30,        "booked": [],        "bookedPerDay": 0,        "freePerDay": 257,        "avgViewersPerBreak": 5000,        "adMinPerHour": {          "all": 4.653334286029524,          "day": 4.525661491443961,          "night": 5.069444444444445        },        "builtWith": {          "enabled": true,          "accounting": "included",          "source": "none",          "vastTagUrl": null,          "avgViewersPerBreak": null,          "inventoryMode": "schedule",          "fillMode": "fixed",          "borrowApply": false,          "reservedSec": 0,          "maxAdsPerBreak": 0,          "hourlyCapSec": 0,          "scope": "channel",          "cueMethod": "scte35",          "spotSec": 30,          "preRoll": {            "on": true,            "pods": 2          },          "midRoll": {            "on": true,            "pods": 3,            "everyMin": 15,            "minTailMin": 8,            "firstBreakAfterMin": 10,            "maxBreaks": 0,            "pattern": "cadence",            "fixedPositionsMin": [              15,              30            ]          },          "postRoll": {            "on": false,            "pods": 2          },          "interProgramSec": 90,          "minProgramMin": 10,          "podPattern": [],          "scte": {            "spliceCommand": "time_signal",            "segmentationType": "provider_po",            "cuePreRollMs": 4000,            "autoReturn": true          },          "daypartCaps": {            "overnight": {              "on": true,              "capMinPerHr": 8            },            "daytime": {              "on": true,              "capMinPerHr": 12            }          },          "rescue": {            "onFail": "house_ads",            "houseAdIds": [],            "playlistId": null,            "playlist": "",            "triggerSec": 3,            "repeatProtectHrs": 2          }        }      }    },    "posterVerticalUrl": null,    "posterLandscapeUrl": null,    "seriesInScope": {      "count": 0,      "items": [],      "scopeHoldsOnlySeries": false    },    "sourcePoolCount": null,    "missingSourceIds": [],    "id": "1dad8739-b86a-4f5e-ab64-28b7f72a717d",    "name": "E2E Ad Channel India",    "slug": "e2e-ad-channel-india",    "archetype": "movie",    "assetTypes": [      "movie"    ],    "region": "US",    "language": "en",    "primeTimeStart": 20,    "primeTimeEnd": 23,    "watershed": {      "hour": 20,      "source": "prime-time",      "enabled": true    },    "timezone": "Asia/Kolkata",    "zone": "Asia/Kolkata",    "broadcastDayStartMin": 0,    "broadcastWeekStart": 1,    "scheduleHorizon": 7,    "maxRepeatWindow": 72,    "autoPublish": true,    "status": "live",    "dnaPrompt": "Campaigns v2 S2.1c fixture — a second in-house channel in another time zone.",    "schedulingPrompt": null,    "streamUrl": null,    "dna": {      "tone": "Campaigns v2 S2.1c fixture — a second in-house channel in another time zone.",      "scope": {        "mode": "catalogs",        "catalogIds": [          "df5b932e-0f47-4395-9beb-0a5a4b06cb28"        ]      },      "adConfig": {        "scte": {          "autoReturn": true,          "cuePreRollMs": 4000,          "spliceCommand": "time_signal",          "segmentationType": "provider_po"        },        "scope": "channel",        "rescue": {          "onFail": "house_ads",          "playlist": "",          "houseAdIds": [],          "playlistId": null,          "triggerSec": 3,          "repeatProtectHrs": 2        },        "source": "campaigns",        "enabled": true,        "midRoll": {          "on": true,          "pods": 3,          "pattern": "cadence",          "everyMin": 15,          "maxBreaks": 0,          "minTailMin": 8,          "fixedPositionsMin": [            15,            30          ],          "firstBreakAfterMin": 10        },        "preRoll": {          "on": true,          "pods": 2        },        "spotSec": 30,        "postRoll": {          "on": false,          "pods": 2        },        "cueMethod": "scte35",        "accounting": "included",        "podPattern": [],        "vastTagUrl": null,        "daypartCaps": {          "daytime": {            "on": true,            "capMinPerHr": 12          },          "overnight": {            "on": true,            "capMinPerHr": 8          }        },        "minProgramMin": 10,        "interProgramSec": 90,        "avgViewersPerBreak": 5000      },      "dayparts": [        {          "end": "24:00",          "days": [            1,            2          ],          "name": "E2E Weekday",          "tone": "family animation",          "start": "00:00",          "rating": "G / PG only"        },        {          "end": "24:00",          "days": [            0,            6          ],          "name": "E2E Weekend",          "tone": "all-ages features",          "start": "00:00",          "rating": "G / PG only"        }      ],      "guidance": "",      "territoryMode": "include"    },    "lastGeneratedAt": "2026-10-28T20:36:28.156Z",    "updatedAt": "2026-10-30T09:06:46.116Z",    "deckUrl": null,    "hasDeckFile": false,    "deckFileUrl": null,    "deckName": null  },  "health": {    "familiarity": 94,    "freshness": 6,    "channelId": 100,    "slots": 102,    "distinctTitles": 6,    "heavyRotation": [      {        "title": "Toy Story",        "airings": 17      },      {        "title": "Coco",        "airings": 17      }    ],    "drift": [      "Overplay: \"Toy Story\" is 17 of 102 airings (17%)",      "Low freshness: only 6 distinct titles across 102 slots"    ]  }}