​
Products

Future Demand — the Audience Intelligence platform as a whole. Lookout — Predict. Demand forecasting for shows and programmes months in advance. Covered in this developer kit. Wave — Promote. Launch high-converting social campaigns in minutes. Covered in this developer kit. Affinity — Recommend. Personal product and event recommendations for partner websites and apps. Hosted at fd-recommender.{env}.future-demand.com with its own credential. See Affinity overview. Backhaul — Retain. Email retention product. Not covered in this developer kit. Sentinel — Understand. Natural-language data Q&A product. Not covered in this developer kit.

​
Identifiers

partner_id — Public partner / tenant identifier. Pattern partner-id-<slug> or fd<digits>. Sent on every request as X-Preferred-Partner-Id. client_id — Internal numeric form of the partner. Returned as id from GET /partners/. Used by a few legacy endpoints; prefer partner_id. eid — Event id. Stable for the life of the event. tc — Taste cluster name. A learned audience segment for one event. Used as a path segment in URLs (URL-encoded, not slugified). tc_run_id — Integer identifier of a specific cluster-generation run for an event. Historical run availability depends on platform retention policies. cid — Client-side composite identifier used for UI navigation and convenience. The API operates on the underlying components (eid, tc, tc_run_id) rather than cid itself. audience_id — Saved-audience id issued by an upstream ad platform (typically Meta) after publish.

​
API model

setup_process — Per-event campaign setup resource used by Wave. The client manages draft and published campaign configuration through the setup-process workflow. taste cluster — A segment of likely buyers for one event, returned by the Client API’s cluster endpoints. Versioned by tc_run_id. benchmark — the prediction model’s output of demand vs. an expected trajectory. Comes back as fraction or percent (auto-detect). sales graph — Normalised time-to-event sales-vs-prediction curve. frontend_status — UX-level event flag: DEFAULT, FLAGGED, HIDDEN. client_campaign_status — User’s pause/run toggle for an event’s Wave campaigns. campaign_optimisation_status — Whether Future Demand’s automated optimisation is active.

​
Auth

Cognito — AWS Cognito, the identity provider behind /auth/*. You don’t need a Cognito SDK; the Future Demand wrapper exposes everything you need. AccessToken — Short-lived (~1h) JWT used as Authorization: Bearer .... IdToken — JWT with the user’s claims, including cognito:groups. Decode to find which partners the user belongs to. RefreshToken — Long-lived token used to mint new access tokens. Does not rotate. Treat as a credential — server-side only. X-Preferred-Partner-Id — Per-request partner selector. Required on every authenticated call.

​
Lifecycle terms

Campaign setup: DRAFT — Editable, autosaved by the wizard. Campaign setup: PUBLISHED — Live on ad platforms. Edits go through POST /campaigns_setup, not the draft endpoint. frontend_status — Event-level UX flag. Values: DEFAULT, FLAGGED, HIDDEN, CANCELLED.

​
Hosts

Main API — https://client-api.prd.future-demand.com/api/v3. The bulk of endpoints. Lookout + Wave. Affinity host — https://fd-recommender.prd.future-demand.com. The recommendations service for partner websites and apps. Separate credential from the main API. See Affinity overview. CR API — Customer Representation service. Separate host from client-api.* — ask your account contact for the URL. Used for event ingest (Event Editor, Simulation, Bulk Upload) and the second half of the status-update dance. Media host — Same hostname as the main API, but without the /v3 suffix (so https://client-api.prd.future-demand.com/api/media). Only used by POST /media.