---
title: "Get a binding quote (REQUIRED before any charge)"
method: POST
path: "/api/v1/quote"
tags: ["Buying"]
---

# Get a binding quote (REQUIRED before any charge)

`POST /api/v1/quote`

## Request

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

Prices a slot and returns a quote_id valid for 30 minutes. The returned total_cost_usd is what you will be charged — nothing else can set the price.

## Request body

- object
  - `format` 'leaderboard_728x90' | 'medium_rectangle_300x250' | 'mobile_banner_320x50' | 'voice_sponsor_read' | 'pregame_anthem_slot' | 'halftime_music_show', required
  - `sport` 'all' | 'gridiron' | 'fnba' | 'pitwall' | 'starsofsoccer' | 'fiba' | 'fifa', required: gridiron=NFL, fnba=WNBA/NBA, pitwall=Formula 1, starsofsoccer=European football, all=run-of-network. fiba/fifa are concluded tournaments (replay vault).
  - `impressions` integer, required: Impressions or audio listeners to reach. Minimum 5,000.
  - `voice_persona` 'The Architect' | 'Marcus' | 'Leo' | 'Sam' | 'Zareena' | 'Big Mike'

## Response `200`

A binding quote.

- QuoteResponse
  - `status` string
  - `quote` object
    - `quote_id` string: Pass this to /api/v1/orders or /api/v1/checkout.
    - `format` 'leaderboard_728x90' | 'medium_rectangle_300x250' | 'mobile_banner_320x50' | 'voice_sponsor_read' | 'pregame_anthem_slot' | 'halftime_music_show'
    - `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).
    - `impressions_guaranteed` integer
    - `effective_cpm_usd` number
    - `volume_discount_pct` number
    - `total_cost_usd` number: Exactly what Stripe will collect.
    - `expires_at` string, date-time
    - `expires_in_seconds` integer
    - `list_cpm_usd` number: Published rate-card CPM for the format.
    - `floor_cpm_usd` number: Hard floor for the format. effective_cpm_usd is never below this.

## Other responses

- `400`: Request rejected. `code` is machine-readable; `message` says how to correct it.
- `429`: Request rejected. `code` is machine-readable; `message` says how to correct it.

---

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