---
title: "Recall Campaign"
method: GET
path: "/v1/recalls-campaigns"
tags: ["Recalls"]
---

# Recall Campaign

`GET /v1/recalls-campaigns`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/v1/recalls-campaigns`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `PAYMENT-SIGNATURE`
  - none
- TypeScript: <https://skmtc.dev/carsxe/apis/carsxe-api/docs/v1/recalls-campaigns/get.ts> (a function with typed inputs; its response is checked against the schema)

Look up a manufacturer recall campaign code (for example Volkswagen `37M2`) and get the recall campaign behind it. Exact match on make and code; a code that is not in the dictionary returns 404 and is not billed. Uses 5 credits per successful Vehicle Recalls lookup.

Credit plans: 5 credits per successful billable lookup. Failed lookups and no-data errors do not use credits. See https://carsxe.com/pricing.md for billing units.

## Query parameters

- `make` string, required
- `code` string, required

## Response `200`

Campaign found.

- object
  - `success` boolean
  - `input` object
    - `make` string: The normalized make.
    - `code` string: The code as sent, trimmed.
  - `data` object
    - `campaign_code` string
    - `recall_class` string: `Safety / Compliance Recall` for a safety recall, otherwise the service bulletin type.
    - `description` string
    - `nhtsa_campaign_number` string: One or more NHTSA campaign numbers separated by `;`. Empty for a bulletin-only code.
    - `component` string: Empty for a bulletin-only code.
    - `models` string: Affected models separated by `;`.
    - `model_years` string: Affected model years separated by `;`.
    - `confidence` 'high' | 'medium (prose reference)'
    - `matched` boolean
    - `dictionary_version` integer
  - `timestamp` string

## Other responses

- `400`: Missing or invalid make or code.
- `401`: Missing API key, unknown/disabled API key, or inactive account.
- `404`: No campaign for this make and code. Not billed.
- `429`: API usage limit exceeded for the current billing period.
- `500`: Internal server error.

## Changes

- **2026-10-01** `399c1f13fa63`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/carsxe/apis/carsxe-api/changes/v1/recalls-campaigns/get.md)

---

[API](https://skmtc.dev/carsxe/apis/carsxe-api.md) - [All operations](https://skmtc.dev/carsxe/apis/carsxe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carsxe/apis/carsxe-api/revisions/ed8f6c024239?raw)