---
title: "Get aggregated carrier risk signals"
method: GET
path: "/v1/carriers/{dot_number}/risk-signals"
---

# Get aggregated carrier risk signals

`GET /v1/carriers/{dot_number}/risk-signals`

## Request

- Base URL: `https://api.runalphaloops.com`
- URL: `https://api.runalphaloops.com/v1/carriers/{dot_number}/risk-signals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/docs/v1/carriers/:dot_number/risk-signals/get.ts> (a function with typed inputs; its response is checked against the schema)

Aggregated carrier risk assessment in a single call. Returns an AI-generated risk score (0-10) and level, plus six signal categories — authority-for-sale listings, equipment-for-sale marketplace matches, financial-distress indicators, fraud/chameleon patterns, historical authority/insurance/change-event patterns, and recent news sentiment. Each category carries a derived level of "high", "medium", "clear", or "unknown". The risk summary is cached; pass force_refresh=true to force regeneration.

## Path parameters

- `dot_number` string, required

## Query parameters

- `force_refresh` boolean
- `include_equipment` boolean

## Response `200`

Scored risk header plus six derived signal categories

- RiskSignalsResponse
  - `dot_number` string
  - `carrier_name` string, nullable
  - `location` object
    - `city` string, nullable
    - `state` string, nullable
  - `risk_score` number, nullable: AI-generated 0–10 risk score
  - `risk_level` string: CRITICAL, HIGH, MEDIUM, LOW, CLEAR, or UNKNOWN
  - `summary` string, nullable
  - `generated_at` string, date-time, nullable
  - `cached` boolean, nullable
  - `summary_available` boolean: False when the upstream summary service was unavailable and a carrier-stored fallback was used.
  - `signals` object
    - `authority_for_sale` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `evidence_summary` string, nullable
      - `mc_sale` object, nullable
    - `equipment_for_sale` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `match_count` integer
      - `matches` object[], nullable
    - `financial_risk` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `confidence` string, nullable
      - `issues` string[]
      - `details` string, nullable
      - `source` string, nullable
      - `source_domains` string[]
    - `fraud_signals` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `is_chameleon` boolean
      - `confidence` string, nullable
      - `indicators` string[]
      - `details` string, nullable
      - `relationship_risk_summary` string, nullable
    - `historical_patterns` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `triggered_combos` RiskTriggeredCombo[]
        - `key` string: Stable combo identifier (e.g. sold_mc_signature_30d)
        - `label` string: Human-readable description
        - `severity` 'high' | 'medium'
      - `insurance` object, nullable
      - `authority` object, nullable
      - `change_events` object, nullable
    - `recent_activity` object
      - `level` 'high' | 'medium' | 'clear' | 'unknown': Derived severity for a single signal category.
      - `subtitle` string
      - `negative_article_count` integer
      - `article_count` integer

## Other responses

- `401`: Invalid or missing API key
- `404`: Carrier does not exist
- `429`: Too many requests. Check X-RateLimit-Remaining and Retry-After headers.

---

[API](https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api.md) - [All operations](https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runalphaloops/apis/alphaloops-fmcsa-carrier-data-api/revisions/ae58c064a7af?raw)