---
title: "Try recorded vehicle facts without a key (1 shared demo unit)"
method: GET
path: "/v1/demo/vehicle_risk"
---

# Try recorded vehicle facts without a key (1 shared demo unit)

`GET /v1/demo/vehicle_risk`

## Request

- Base URL: `https://api.theusedcarindex.com`
- URL: `https://api.theusedcarindex.com/v1/demo/vehicle_risk`
- Auth: none required

Rate limited and meant for trying the API. Real use needs a key. Uses shared demo quotas and returns 503 when the demo is not configured.

## Query parameters

- `make` string, required
- `model` string, required
- `year` integer, required

## Response `200`

Success

- VehicleRisk
  - `vehicle` Vehicle, required
    - `make` string, required
    - `model` string, required
    - `year` integer, required
    - `family_key` string, required
    - `matched_models` object[], required: matched_models lists the vehicle's own NHTSA labels that carry complaints, or all of its own labels with count 0 when the vehicle has no complaints; other_names lists zero-count own labels of a vehicle that has complaints and alternate NHTSA labels, including lookup-only aliases.
      - `model` string, required
      - `complaints` integer, required
    - `other_names` string[], required: matched_models lists the vehicle's own NHTSA labels that carry complaints, or all of its own labels with count 0 when the vehicle has no complaints; other_names lists zero-count own labels of a vehicle that has complaints and alternate NHTSA labels, including lookup-only aliases.
    - `resolved_via` 'vehicle_models' | 'model_aliases' | 'family_key', required
  - `complaints` object, required
    - `total` integer, required
    - `with_crash` integer, required
    - `with_fire` integer, required
    - `with_injury` integer, required
    - `injuries` integer, required
    - `deaths` integer, required
    - `by_source` object, required
      - `both` integer, required
      - `bulk_only` integer, required
      - `api_only` integer, required
    - `coverage_complete` boolean, required
    - `top_systems` object[], required
      - `system` string, required
      - `count` integer, required
      - `share` number, required: Distinct complaint records naming this system divided by complaints.total; a single share never exceeds 1. Shares across systems can sum above 1.
    - `top_subsystems` object[], required
      - `system` string, required
      - `subsystem` string, required
      - `count` integer, required
  - `recalls` object, required
    - `total` integer, required
    - `do_not_drive` integer, required
    - `park_outside` integer, required
    - `potential_units_max` number, nullable, required
    - `by_system` object[], required
      - `system` string, required
      - `count` integer, required
    - `latest` object[], required
      - `campaign_number` string, required
      - `received_date` string, nullable, required
      - `systems` string[], required
      - `defect` string, nullable, required
      - `consequence` string, nullable, required
      - `remedy` string, nullable, required
      - `do_not_drive` boolean, nullable, required
      - `park_outside` boolean, nullable, required
      - `truncated` boolean, required
      - `url` string, required
  - `investigations` object, required
    - `total` integer, required
    - `open` integer, required
    - `items` object[], required
      - `action_number` string, required
      - `opened_date` string, nullable, required
      - `closed_date` string, nullable, required
      - `campaign_numbers` string[], required
      - `subject` string, nullable, required
      - `summary` string, nullable, required
      - `systems` string[], required
      - `url` string, nullable, required
  - `manufacturer_communications` object, required
    - `total` integer, required
    - `by_system` object[], required
      - `system` string, required
      - `subsystem` string, required: The empty string means all subsystems of this system; by_subsystem holds the subsystem rows.
      - `source_field` string, required
      - `count` integer, required
    - `by_subsystem` object[], required
      - `system` string, required
      - `subsystem` string, required
      - `source_field` string, required
      - `count` integer, required
    - `recent` object[], required
  - `rate` Rate, required
    - `complaints_per_100k_sold` number, nullable, required
    - `units_sold` number, nullable, required
    - `sales_year` number, nullable, required
    - `basis` string, nullable, required
    - `source` string, nullable, required
    - `source_url` string, nullable, required
    - `null_reason` string, nullable, required
  - `model_tags` ModelTags, required
    - `model` union, required: Stored tagged_by provenance. One model string, or all model versions if several contributed.
      - string
      - string[]
    - `schema_version` 'tag-v1', required
    - `tagged_complaints` integer, required
    - `complaints_total` integer, required
    - `tagged_share` number, required: Tagged complaints divided by the NHTSA complaint total.
    - `failure_modes` object[], required
      - `label` 'mechanical_failure' | 'electrical_electronic' | 'fluid_or_fuel_leak' | 'fire_or_overheating' | 'loss_of_control' | 'restraint_or_airbag' | 'visibility_or_lighting' | 'structural_or_corrosion' | 'noise_or_comfort' | 'unclear', required
      - `count` integer, required
      - `share` number, required: Count divided by tagged_complaints.
      - `mean_confidence` number, required: Stored mean of the model probabilities for this chosen label; not accuracy.
      - `high_confidence_count` integer, required: Confidence at least 0.8.
      - `low_confidence_count` integer, required: Confidence below 0.5.
    - `severities` object[], required
      - `label` 'none' | 'low' | 'moderate' | 'high' | 'critical', required
      - `count` integer, required
      - `share` number, required: Count divided by tagged_complaints.
      - `mean_confidence` number, required: Stored mean of the model probabilities for this chosen label; not accuracy.
      - `high_confidence_count` integer, required: Confidence at least 0.8.
      - `low_confidence_count` integer, required: Confidence below 0.5.
    - `confidence_note` string, required: Confidence is the model's own probability for the label it chose (0 to 1), not accuracy.
    - `note` string, required: Jev tags exist for model years 2012 and newer; model year 2012 is only partly tagged and earlier model years carry no tags. tagged_share gives each vehicle's tagged fraction; about 43 percent of all complaints are tagged. Built from data_build.tag_coverage: model years {full_from_model_year} and newer are tagged in full, the partial year or range in part when those years differ (a single year is written once), and earlier model years have no tags. When tag_coverage is absent, the note says tagged_share gives the vehicle's tagged fraction. NHTSA's own flags remain separate in the complaints block.
  - `model_tags_null_reason` unknown, required
  - `data` object, required
    - `built_at` string, nullable, required
    - `sources` object[], required
      - `name` string, required
      - `url` string, required
    - `notes` string[], required

## Other responses

- `400`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `401`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `403`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `404`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `405`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `413`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `415`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `429`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `500`: RFC 9457 problem with stable code; 429 includes Retry-After.
- `503`: RFC 9457 problem with stable code; 429 includes Retry-After.

---

[API](https://skmtc.dev/theusedcarindex/apis/the-used-car-index.md) · [All operations](https://skmtc.dev/theusedcarindex/apis/the-used-car-index/llms.txt) · [OpenAPI document](https://skmtc.dev/theusedcarindex/apis/the-used-car-index/revisions/80dd1305d05c?raw)