---
title: "Returns the spot insertions matching the query parameters."
method: GET
path: "/api/v2/spotinsertions"
tags: ["Spot Insertions"]
---

# Returns the spot insertions matching the query parameters.

`GET /api/v2/spotinsertions`

## Query parameters

- `pageStart` integer
- `pageSize` integer
- `orderById` 'asc' | 'desc'

## Response `200`

The spot insertions matching the query parameters

- SpotInsertion[]
  - `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.

---

[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)