---
title: "Latest campaigns, newest first"
method: GET
path: "/v2/recalls/feed"
tags: ["recalls"]
---

# Latest campaigns, newest first

`GET /v2/recalls/feed`

## Request

- Base URL: `https://api.cardog.app`
- URL: `https://api.cardog.app/v2/recalls/feed`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

The live recall log

- RecallsFeed
  - `recalls` object[], required
    - `ref` string, required: Entity ref ({domain}:{key}) in the "recall" domain. Example: "recall:tc/2024-123"
    - `authority` string, required: Issuing authority key: "tc" (Transport Canada) or "nhtsa". Other values may be added.
    - `authorityLabel` string, required: Display label, e.g. "Transport Canada"
    - `campaignNumber` string, required
    - `component` string, nullable, required
    - `defectSummary` string, nullable, required
    - `consequenceSummary` string, nullable, required
    - `correctiveAction` string, nullable, required
    - `recallDate` string, nullable, required: Date the recall was issued (ISO date, YYYY-MM-DD)
    - `notificationType` string, nullable, required
    - `unitsAffected` integer, nullable, required: Units affected by the whole campaign (the largest value across `affects`)
    - `affects` object[], required: Affected model years. When queried by entity, only that entity's model years are listed.
      - `modelYearRef` string, required: Entity ref ({domain}:{key}) in the "model-year" domain. Example: "model-year:toyota/rav4/2021"
      - `year` integer, required
      - `unitsAffected` integer, nullable, required
    - `links` object: Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}
  - `links` object: Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

## Other responses

- `401`: No valid credential (API key, session, or internal token)
- `429`: Per-minute rate limit exceeded
- `500`: Internal error

---

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