---
title: "Ad formats, CPM floors, and real remaining capacity"
method: GET
path: "/api/v1/inventory"
tags: ["Discovery"]
---

# Ad formats, CPM floors, and real remaining capacity

`GET /api/v1/inventory`

## Request

- Base URL: `https://neuronsystems.org`
- URL: `https://neuronsystems.org/api/v1/inventory`
- Auth: none declared

Returns each ad format with its published list CPM, the biddable hard floor, daily capacity, and the REAL impressions still available today from the live booking ledger. Start here.

## Query parameters

- `sport` 'all' | 'gridiron' | 'fnba' | 'pitwall' | 'starsofsoccer' | 'fiba' | 'fifa': gridiron=NFL, fnba=WNBA/NBA, pitwall=Formula 1, starsofsoccer=European football, all=run-of-network. fiba/fifa are concluded tournaments (replay vault).
- `format` 'leaderboard_728x90' | 'medium_rectangle_300x250' | 'mobile_banner_320x50' | 'voice_sponsor_read' | 'pregame_anthem_slot' | 'halftime_music_show'

## Response `200`

Inventory with live availability.

- InventoryResponse
  - `status` string
  - `target_sport` string
  - `minimum_order_impressions` integer
  - `volume_discount_tiers` object[]
    - `min_impressions` integer
    - `discount_pct` number
  - `inventory` object[]
    - `format` 'leaderboard_728x90' | 'medium_rectangle_300x250' | 'mobile_banner_320x50' | 'voice_sponsor_read' | 'pregame_anthem_slot' | 'halftime_music_show'
    - `title` string
    - `available_impressions_today` integer
    - `sold_impressions` integer
    - `list_cpm_usd` number: Published rate-card CPM, before targeting premium or volume discount.
    - `floor_cpm_usd` number: Hard floor: the lowest CPM the exchange will sell or accept a bid at.
    - `cpm_floor_usd` number: DEPRECATED alias of list_cpm_usd, retained for older clients.

---

[API](https://skmtc.dev/neuronsystems/apis/neuron-sports-ad-exchange-api.md) · [All operations](https://skmtc.dev/neuronsystems/apis/neuron-sports-ad-exchange-api/llms.txt) · [OpenAPI document](https://skmtc.dev/neuronsystems/apis/neuron-sports-ad-exchange-api/revisions/980421bb95a0?raw)