Skip to main content

​
Briefing History

Returns an array of past weekly briefings for time-series analysis and historical comparison. Each entry follows the same schema as the Latest Briefing response.

​
Endpoint

GET /api/briefing/history

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Query Parameters

​
geography
string
required
ISO 3166-1 alpha-2 country code (e.g. US, UK).
​
weeks
number
default:"4"
Number of weeks of history to return. Maximum 52.

​
Response

​
briefings
array
Array of WeeklyBriefing objects ordered by weekStart descending (most recent first). Each object follows the full briefing schema documented in Latest Briefing.
​
count
number
Number of briefings returned.

​
Code Examples

curl -X GET "https://api.consumersignals.io/api/briefing/history?geography=US&weeks=8" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "briefings": [
    {
      "weekStart": "2026-03-30",
      "headline": "Discount-seeking intensity eases as spring demand normalises",
      "classification": "stabilisation",
      "score": 54,
      "sections": { "..." : "..." },
      "companyExposure": { "highRisk": ["DG"], "defensive": ["WMT"] },
      "keyDates": [],
      "generatedAt": "2026-03-31T06:00:00Z"
    },
    {
      "weekStart": "2026-03-23",
      "headline": "Trade-down signals persist amid softening discretionary spend",
      "classification": "moderate_deterioration",
      "score": 48,
      "sections": { "..." : "..." },
      "companyExposure": { "highRisk": ["DG", "KSS"], "defensive": ["COST"] },
      "keyDates": [],
      "generatedAt": "2026-03-24T06:00:00Z"
    }
  ],
  "count": 2
}