Buying

Book a flight against a quote_id

Books the flight and returns an order_id plus a Stripe Checkout URL for exactly the quoted amount. Price and impressions come from the stored quote. Send an Idempotency-Key header so a retry does not double-book.

post/api/v1/orders

Request

  • Base URL: https://neuronsystems.org
  • URL: https://neuronsystems.org/api/v1/orders
  • Auth: none declared

Headers

Idempotency-Keystring

Reuse the same value when retrying to get the original result back.

Request body

quote_idstring required

From POST /api/v1/quote.

ad_category'general' | 'alcohol' | 'betting' required

What the sponsor sells. alcohol and betting ads are shown only to signed in fans who have told us they are 21 or over; general ads are shown to everyone.

brand_namestring required
headlinestring
click_urlstring uri required

HTTPS only.

image_urlstring uri

Required for display formats.

voice_scriptstring

Required for voice_sponsor_read. Maximum 35 words (~15 seconds).

selected_persona'The Architect' | 'Marcus' | 'Leo' | 'Sam' | 'Zareena' | 'Big Mike'
track_titlestring

Required for music slots.

artist_namestring

Required for music slots.

audio_stream_urlstring uri

Required for music slots.

cover_art_urlstring uri
streaming_platform_urlstring uri
rights_confirmedboolean

Must be true for music slots: you confirm licensing or ownership.

advertiser_emailstring email
idempotency_keystring

Response

Order booked; pay at checkout.url.

statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.