--- title: "GET /channel/{ChannelName}/program/{ProgramName}" method: GET path: "/channel/{ChannelName}/program/{ProgramName}" --- # GET /channel/{ChannelName}/program/{ProgramName} `GET /channel/{ChannelName}/program/{ProgramName}` Describes a program within a channel. For information about programs, see Working with programs in the MediaTailor User Guide. ## Path parameters - `ChannelName` string, required - `ProgramName` string, required ## Response `200` Success - DescribeProgramResponse - `AdBreaks` AdBreak[] — The ad break configuration settings. - `MessageType` 'SPLICE_INSERT' | 'TIME_SIGNAL' — The SCTE-35 ad insertion type. Accepted value: SPLICE_INSERT, TIME_SIGNAL. - `OffsetMillis` integer — How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped. - `Slate` object — Ad break slate configuration. - `SourceLocationName` string — The name of the source location where the slate VOD source is stored. - `VodSourceName` string — The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate. - `SpliceInsertMessage` object — This defines the SCTE-35 splice_insert() message inserted around the ad. For information about using splice_insert(), see the SCTE-35 specficiaiton, section 9.7.3.1. - `AvailNum` integer — This is written to splice_insert.avail_num, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. - `AvailsExpected` integer — This is written to splice_insert.avails_expected, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. - `SpliceEventId` integer — This is written to splice_insert.splice_event_id, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 1. - `UniqueProgramId` integer — This is written to splice_insert.unique_program_id, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive. - `TimeSignalMessage` object —

Defines the SCTE-35 time_signal message inserted around the ad.

Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a splice_insert SCTE-35 message to the ad break. This message provides basic metadata about the ad break.

See section 9.7.4 of the 2022 SCTE-35 specification for more information.

- `SegmentationDescriptors` SegmentationDescriptor[] — The configurations for the SCTE-35 segmentation_descriptor message(s) sent with the time_signal message. - `SegmentNum` integer — The segment number to assign to the segmentation_descriptor.segment_num message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0. - `SegmentationEventId` integer — The Event Identifier to assign to the segmentation_descriptor.segmentation_event_id message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1. - `SegmentationTypeId` integer — The Type Identifier to assign to the segmentation_descriptor.segmentation_type_id message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48. - `SegmentationUpid` string — The Upid to assign to the segmentation_descriptor.segmentation_upid message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string). - `SegmentationUpidType` integer — The Upid Type to assign to the segmentation_descriptor.segmentation_upid_type message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14. - `SegmentsExpected` integer — The number of segments expected, which is assigned to the segmentation_descriptor.segments_expectedS message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0. - `SubSegmentNum` integer — The sub-segment number to assign to the segmentation_descriptor.sub_segment_num message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null. - `SubSegmentsExpected` integer — The number of sub-segments expected, which is assigned to the segmentation_descriptor.sub_segments_expected message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null. - `Arn` string — The ARN of the program. - `ChannelName` string — The name of the channel that the program belongs to. - `ClipRange` object — The clip range configuration settings. - `EndOffsetMillis` integer, required — The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program. - `CreationTime` string, date-time — The timestamp of when the program was created. - `DurationMillis` integer — The duration of the live program in milliseconds. - `LiveSourceName` string — The name of the LiveSource for this Program. - `ProgramName` string — The name of the program. - `ScheduledStartTime` string, date-time — The date and time that the program is scheduled to start in ISO 8601 format and Coordinated Universal Time (UTC). For example, the value 2021-03-27T17:48:16.751Z represents March 27, 2021 at 17:48:16.751 UTC. - `SourceLocationName` string — The source location name. - `VodSourceName` string — The name that's used to refer to a VOD source. --- [API](https://skmtc.net/aws/apis/mediatailor.md) · [All operations](https://skmtc.net/aws/apis/mediatailor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/mediatailor/versions/52c4c025987a/schema)