---
title: "Returns the spot insertion matching the given ID."
method: GET
path: "/api/v2/spotinsertions/{id}"
tags: ["Spot Insertions"]
---

# Returns the spot insertion matching the given ID.

`GET /api/v2/spotinsertions/{id}`

## Response `200`

The spot insertion with the given ID.

- SpotInsertion — A spot insertion for playing a series of spots when a cue is received during a program.
  - `id` integer — The unique ID of the spot insertion. Generated at creation.
  - `programId` integer, required — The ID of the program for the spot insertion.
  - `broadcastServiceId` integer, required — The ID of the broadcast service for the spot insertion.
  - `customerId` integer — The ID of the customer who owns the spot insertion. Set to the logged-in customer at creation.
  - `cue` string, required — The cue that triggers the spot insertion.
  - `duration` integer, required — The duration of the spot insertion.
  - `spots` integer[], required — The ordered list of spot IDs to play.
  - `startDate` string, date, required — The date the spot insertion can start in yyyyMMdd format. The time will be set to midnight Eastern Time.
  - `endDate` string, date, required — The date the spot insertion ends in yyyyMMdd format. The time will be set to midnight Eastern Time.
  - `createdDate` string, date-time — The date and time the spot insertion was created in ISO 8601 format. Generated at creation.

## Other responses

- `403` — Authorization failed, or the user is not permitted to view the spot insertion.
- `404` — The spot insertion cannot be found.

---

[API](https://skmtc.dev/prss/apis/contentdepot.md) · [All operations](https://skmtc.dev/prss/apis/contentdepot/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prss/contentdepot/revisions/838e7ae589d8/schema)