Skip to main content
GET
/
api
/
cpix
CPIx Score
curl --request GET \
  --url https://api.example.com/api/cpix
{
  "summary": {
    "score": 123,
    "change": 123,
    "changePercent": 123,
    "timestamp": "<string>",
    "classification": "<string>",
    "previousScore": 123,
    "latestDataDate": "<string>",
    "computedAt": "<string>"
  },
  "drivers": [
    {
      "id": "<string>",
      "name": "<string>",
      "value": 123,
      "unit": "<string>",
      "direction": "<string>",
      "contribution": 123,
      "description": "<string>",
      "trend": [
        {}
      ]
    }
  ],
  "geography": "<string>",
  "lastUpdated": "<string>"
}
Returns the latest CPIx proprietary composite score for a given geography, including month-over-month change, classification, and a full breakdown of contributing drivers with 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

​
summary
object
Composite score summary.
​
drivers
array
Array of driver objects that contribute to the proprietary composite score.
​
geography
string
Geography code for the returned data.
​
lastUpdated
string
ISO 8601 timestamp of the last data refresh.

​
Examples

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

​
Example Response

{
  "summary": {
    "score": 62.4,
    "change": -1.8,
    "changePercent": -2.8,
    "timestamp": "2026-03-28T00:00:00Z",
    "classification": "rising_pressure",
    "previousScore": 64.2,
    "latestDataDate": "2026-03-28",
    "computedAt": "2026-03-29T04:12:00Z"
  },
  "drivers": [
    {
      "id": "driver_01",
      "name": "Inflation Gauge",
      "value": 3.1,
      "unit": "%",
      "direction": "up",
      "contribution": 0.72,
      "description": "Annual change in a primary inflation metric.",
      "trend": [2.9, 3.0, 3.0, 3.1]
    }
  ],
  "geography": "US",
  "lastUpdated": "2026-03-29T04:12:00Z"
}