Skip to main content

​
Company Exposure

Returns the consumer-signal exposure score, risk level, and sector context for a single company identified by ticker. Use this to assess how a specific name is positioned relative to the current consumer-signal environment.

​
Endpoint

GET /api/companies/:ticker

​
Authentication

Requires a valid JWT passed via the Authorization header.

​
Path Parameters

​
ticker
string
required
Stock ticker symbol (e.g. WMT, DG, TSCO.L).

​
Response

​
ticker
string
The ticker queried.
​
name
string
Company name.
​
sector
string
Sector the company is mapped to (e.g. retail, grocery).
​
geography
string
Primary geography for the company.
​
exposureScore
number
Consumer-signal exposure score (0–100). Higher values indicate greater sensitivity to current consumer stress signals.
​
riskLevel
string
Categorical risk level. One of low, moderate, elevated, high.
​
rationale
string
Narrative explanation of the exposure drivers.
​
sectorContext
object
Summary of the sector environment this company operates within, including pressureScore, trend, and activeSignals.

​
Code Examples

curl -X GET "https://api.consumersignals.io/api/companies/DG" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "ticker": "DG",
  "name": "Dollar General",
  "sector": "retail",
  "geography": "US",
  "exposureScore": 82,
  "riskLevel": "high",
  "rationale": "Core demographic highly sensitive to discount-seeking and credit-stress signals, both of which remain elevated. Trade-down momentum is accelerating into DG's addressable market, but margin pressure from promotional intensity offsets volume gains.",
  "sectorContext": {
    "pressureScore": 64,
    "trend": "stable",
    "activeSignals": ["discount_seeking_elevated", "trade_down_moderate"]
  }
}