---
title: "List ad slot impressions"
method: GET
path: "/v1/ad-slots/{id}/impressions"
tags: ["ad-slots"]
---

# List ad slot impressions

`GET /v1/ad-slots/{id}/impressions`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/ad-slots/{id}/impressions`
- Auth: HTTP bearer

List what an ad slot has actually played, and whether each impression beacon was recorded successfully. Results are returned newest first and the response is capped at 200 records. Use this to reconcile playback against an advertiser's invoice.

**Notes.**
- The newest 200 plays.

## Path parameters

- `id` string, required

## Response `200`

Success.

- object
  - `data` object[], required
    - `id` string, required
    - `spaceId` string, required
    - `slotId` string, required
    - `screenId` string, required
    - `creativeId` string, required: The ad server's creative id.
    - `playKey` string, required: A unique key for this play.
    - `playedAt` string, required: ISO-8601 timestamp (UTC).
    - `beaconsOk` integer, required: Tracking beacons that the ad server accepted.
    - `beaconsFailed` integer, required
    - `createdAt` string, required: ISO-8601 timestamp (UTC).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `404`: No such ad slot in this workspace.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)