---
title: "One recall campaign with every vehicle it lists."
method: GET
path: "/v1/recalls/{source}/{campaign}"
tags: ["Recalls"]
---

# One recall campaign with every vehicle it lists.

`GET /v1/recalls/{source}/{campaign}`

## Request

- Base URL: `https://open.wenmarpro.com`
- URL: `https://open.wenmarpro.com/v1/recalls/{source}/{campaign}`
- Auth: none declared

## Path parameters

- `source` string, required
- `campaign` string, required

## Response `200`

The campaign.

- RecallCampaign: One campaign with every vehicle it lists.
  - `as_of` string, nullable: The day this publisher's data was current.
  - `attribution` string[], required
  - `campaign` string, required
  - `completion` RecallCompletion: The newest report of remedy progress a manufacturer filed with NHTSA for a campaign. The counts are totals for the whole campaign at the end of the period named, which may be years past. They say nothing of one vehicle: check a VIN at the addresses in `lookup`.
    - `as_of` string, nullable: The day NHTSA's report files were current.
    - `involved` integer, required: Vehicles in the campaign.
    - `kind` string, required: `quarterly` or `annual`.
    - `period_from` string, required: The first quarter the report covers, as a year and a quarter.
    - `period_to` string, required: The last quarter it covers. The counts are as of the end of it. A quarterly report has the same quarter in both.
    - `remedied` integer, required: Of those, reported remedied.
    - `remedied_percent` integer, nullable: `remedied` as a share of `involved`, in whole percent, rounded down. `null` when `involved` is 0.
    - `removed` integer, required: NHTSA's "total removed", as reported.
    - `report_number` integer, required: The report's number among those of its kind, from 1.
    - `submitted` string, nullable: The day the manufacturer filed the report.
    - `unreachable` integer, required: NHTSA's "total unreachable", as reported.
  - `component` string, nullable
  - `consequence` string, nullable
  - `country` string, required
  - `date` string, nullable
  - `do_not_drive` boolean, nullable
  - `french` RecallFrench: Transport Canada's French text for a campaign.
    - `component` string, nullable
    - `notification` string, nullable
    - `summary` string, nullable
  - `lookup` RecallLookup, required: Where to check one vehicle for open recalls. Neither government publishes recalls by VIN as data, so no answer here can say a recall applies to a VIN: these lookups can.
    - `maker` string, nullable: The maker's own lookup by VIN, where one is on file.
    - `nhtsa` string, required: NHTSA's lookup by VIN, for the United States.
    - `tc` string, required: Transport Canada's recall search, for Canada.
  - `manufacturer` string, nullable
  - `may_apply` boolean, required: Always `true`: the campaign may apply to a vehicle it lists.
  - `mfr_campaign` string, nullable
  - `notes` string, nullable
  - `notification` string, nullable
  - `owner_notified` string, nullable: The day owners were notified.
  - `park_outside` boolean, nullable
  - `part_number` string, nullable: The manufacturer's part numbers, separated by commas.
  - `remedy` string, nullable
  - `source` string, required
  - `summary` string, nullable
  - `units` integer, nullable
  - `url` string, required: The campaign's page on this site.
  - `vehicles` RecallCampaignVehicle[], required: Every vehicle the campaign lists, by make, model and year.
    - `built_from` string, nullable
    - `built_to` string, nullable
    - `make` string, required: The make and model as the source words them.
    - `match` string, nullable: `exact`, `base` or `curated`; `null` when the model is not in the catalog, as for most heavy trucks, buses and trailers.
    - `model` string, required
    - `vehicle_id` string, nullable: The catalog's id for the model year, when the model matched.
    - `year` integer, nullable

## Other responses

- `404`: `not_found`: no campaign has that number. `dataset_unavailable`: this server holds no recalls from that publisher.

---

[API](https://skmtc.dev/wenmarpro/apis/wenmar-open.md) · [All operations](https://skmtc.dev/wenmarpro/apis/wenmar-open/llms.txt) · [OpenAPI document](https://skmtc.dev/wenmarpro/apis/wenmar-open/revisions/1027b548b6f0?raw)