Partner APIEndpoint reference
Demand changes
Pull stable incremental changes after a completed snapshot.
GET
/api/partner/v1/demand/changesDate-window filters are intentionally unsupported because window membership is defined by the current public row snapshot. To change a date window, discard incremental state, fetch a new complete /gaps snapshot with from/to, and retain its terminal checkpoint. A 409 response likewise requires this full-resync recovery.
Requests require a dedicated bearer token in the Authorization header. This documentation does not execute requests or store credentials. Use the examples in a secure local shell.
Parameters
| Name | Location | Required | Type | Description |
|---|---|---|---|---|
| risk_type | query | No | input_cost_energy, input_cost_food_ag, input_cost_metals_materials, input_cost_technology, ops_disruption_weather, demand_macro, demand_local_event, financing_rates, fx_import_export, promo_marketing, idiosyncratic_supplier, regulatory_policy_cost, equity_market, crypto_price, election_outcome, unmapped | |
| evidence_class | query | No | modeled_gap, observed_gap, explicit_request | |
| business_segment | query | No | food_hospitality, retail, construction_trades, manufacturing, agriculture, transport_logistics, professional_services, technology_crypto, sports_promotion, other, unspecified | |
| coarse_geography | query | No | us_national, us_northeast, us_south, us_midwest, us_west, non_us, multi_region, unspecified | |
| page_size | query | No | integer | |
| cursor | query | No | string | Opaque cursor returned by the same resource |
Responses
| Status | Meaning |
|---|---|
| 200 | Stable incremental change page. Small observed and explicit cells produce no change item. |
| 400 | Invalid parameter or cursor |
| 401 | Missing or invalid scoped bearer token |
| 409 | A full initial sync or reset is required before incremental pulls can continue. |
| 429 | Request limit reached |
| 503 | Partner Demand service is temporarily unavailable |