---
title: "GET /openrecalls/{vin}"
method: GET
path: "/openrecalls/{vin}"
tags: ["openrecalls"]
---

# GET /openrecalls/{vin}

`GET /openrecalls/{vin}`

## Path parameters

- `vin` string, required — Vehicle Identification Number

## Query parameters

- `make` string
- `model` string
- `recalls` 'true' | 'false'
- `year` string

## Response `200`

Success

- object
  - `api` API
    - `description` string, required
    - `from` string, required
    - `login` string, required
    - `name` string, required
    - `repo` string, required
    - `signup` string, required
    - `type` string, required
    - `url` string, required
  - `data` OpenRecalls[], required — Open recalls for this specific VIN. Closed/remedied campaigns are excluded.
    - `component` string
    - `consequence` string
    - `consequenceSummary` string
    - `correctiveAction` string
    - `defectSummary` string
    - `make` string
    - `manufacturer` string
    - `mfrCampaignNumber` string — Manufacturer's own campaign id, e.g. "12D".
    - `mfrNotes` string
    - `model` string
    - `modelYear` string
    - `nhtsaCampaignNumber` string, required — NHTSA campaign id, e.g. "25V170" (may be empty for OEM-only campaigns).
    - `notes` string
    - `overTheAirUpdate` boolean — Resolvable via OTA software update without a dealer visit.
    - `parkIt` boolean — Do-not-drive safety flag.
    - `parkOutSide` boolean — Park-away-from-structures (fire/explosion) safety flag.
    - `pdf` string — Link to the manufacturer's recall PDF, when available.
    - `recallDate` string
    - `recallDescription` string
    - `remedy` string
    - `remedyAvailable` boolean — True when the remedy/parts are available at dealers now.
    - `reportReceivedDate` string
    - `source` string — Upstream source identifier, e.g. "mopar-recallinfo".
    - `status` string — Status as reported by the source ("Open", "Closed", "Recall Incomplete", "Completed", …).
    - `summary` string — Short title / summary of the campaign.
  - `examples` object — Navigation links to related resources.
  - `openRecalls` number, required — Number of open recalls — equals `data.length`.
  - `recalls` OpenRecalls[] — Full make/model/year recall catalog (open + closed). Present only when the request includes `?recalls=true`.
    - `component` string
    - `consequence` string
    - `consequenceSummary` string
    - `correctiveAction` string
    - `defectSummary` string
    - `make` string
    - `manufacturer` string
    - `mfrCampaignNumber` string — Manufacturer's own campaign id, e.g. "12D".
    - `mfrNotes` string
    - `model` string
    - `modelYear` string
    - `nhtsaCampaignNumber` string, required — NHTSA campaign id, e.g. "25V170" (may be empty for OEM-only campaigns).
    - `notes` string
    - `overTheAirUpdate` boolean — Resolvable via OTA software update without a dealer visit.
    - `parkIt` boolean — Do-not-drive safety flag.
    - `parkOutSide` boolean — Park-away-from-structures (fire/explosion) safety flag.
    - `pdf` string — Link to the manufacturer's recall PDF, when available.
    - `recallDate` string
    - `recallDescription` string
    - `remedy` string
    - `remedyAvailable` boolean — True when the remedy/parts are available at dealers now.
    - `reportReceivedDate` string
    - `source` string — Upstream source identifier, e.g. "mopar-recallinfo".
    - `status` string — Status as reported by the source ("Open", "Closed", "Recall Incomplete", "Completed", …).
    - `summary` string — Short title / summary of the campaign.
  - `retrievedAt` unknown, required
  - `status` string, required — Human-readable summary, e.g. "1 Open Recall" or "No Open Recalls".
  - `totalRecalls` number, required — Total campaigns issued for this year/make/model, including ones already remedied for this VIN, so it can exceed `openRecalls`.
  - `vehicle` object, required — Decoded vehicle the recalls pertain to.
    - `make` string, required
    - `model` string, required
    - `vin` string, required
    - `year` string, required
  - `user` ApiUser
    - `accessState` 'active' | 'suspended'
    - `admin` boolean
    - `authenticated` boolean, required
    - `browser` string
    - `city` string, required
    - `continent` string, required
    - `country` string, required
    - `edgeDistanceKilometers` number
    - `edgeDistanceMiles` number
    - `edgeLocation` string, required
    - `email` string
    - `flag` string, required
    - `image` string
    - `ip` string, required
    - `isp` string, required
    - `latencyMilliseconds` number, required
    - `localTime` string, required
    - `metro` string, required
    - `name` string
    - `org` string
    - `os` string, required
    - `plan` 'Free' | 'Starter' | 'Growth' | 'Scale', required
    - `recentInteractions` number, required
    - `region` string, required
    - `requestId` string, required
    - `serviceLatency` number
    - `support` string
    - `timezone` string, required
    - `trustScore` number, required
    - `upgrade` string
    - `userAgent` string
    - `zipcode` string

---

[API](https://skmtc.net/auto/apis/drivly-api.md) · [All operations](https://skmtc.net/auto/apis/drivly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/auto/drivly-api/revisions/8fb62eeae60e/schema)