---
title: "Get an ad slot's fill health"
method: GET
path: "/v1/ad-slots/{id}/health"
tags: ["ad-slots"]
---

# Get an ad slot's fill health

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

## Request

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

Returns fill health for an ad slot over a time window (24 hours by default): ads requested, leased, played, confirmed, expired and not filled, errors, spend, expiry rates, display and confirmation delays, and the screens that requested ads. These are the numbers the ad exchange checks. Available only to workspaces with digital-out-of-home enabled.

## Path parameters

- `id` string, required

## Response `2XX`

Success. Body is `{ data: … }` unless the endpoint serves bytes. The shape of `data` is not yet modelled for this operation.

## Other responses

- `4XX`: Client error. 404 rather than 403 for another tenant's resource, so account existence is not leaked.
- `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)