Skip to main content
GET
/
api
/
drivers
Drivers
curl --request GET \
  --url https://api.example.com/api/drivers
{
  "drivers": [
    {
      "id": "<string>",
      "name": "<string>",
      "value": 123,
      "unit": "<string>",
      "direction": "<string>",
      "contribution": 123,
      "description": "<string>",
      "trend": [
        {}
      ]
    }
  ],
  "count": 123,
  "lastUpdated": "<string>"
}
Returns all drivers that feed into the CPIx composite score, including their current values, directional movement, contribution weights, and sparkline trend data.

​
Authentication

Requires a valid JWT token in the Authorization header. 
Authorization: Bearer <token>

​
Query Parameters

​
geography
string
default:"US"
Target geography. Supported values: US, UK.

​
Response

​
drivers
array
Array of driver objects.
​
count
number
Total number of drivers returned.
​
lastUpdated
string
ISO 8601 timestamp of the last data refresh.

​
Examples

curl -X GET "https://api.consumersignals.io/api/drivers?geography=US" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "drivers": [
    {
      "id": "cpi_yoy",
      "name": "CPI Year-over-Year",
      "value": 3.1,
      "unit": "%",
      "direction": "up",
      "contribution": 0.72,
      "description": "Annual change in the Consumer Price Index, a primary gauge of headline inflation.",
      "trend": [2.9, 3.0, 3.0, 3.1]
    },
    {
      "id": "gas_prices",
      "name": "Gasoline Prices",
      "value": 3.54,
      "unit": "$/gal",
      "direction": "down",
      "contribution": -0.15,
      "description": "National average retail gasoline price, a key input to consumer sentiment.",
      "trend": [3.68, 3.62, 3.58, 3.54]
    }
  ],
  "count": 2,
  "lastUpdated": "2026-03-29T04:12:00Z"
}