---
title: "Manufacturer communications, newest first: every one, or those narrowed by make, model, year, type, component, trouble code, topic or free text."
method: GET
path: "/v1/bulletins"
tags: ["Bulletins"]
---

# Manufacturer communications, newest first: every one, or those narrowed by make, model, year, type, component, trouble code, topic or free text.

`GET /v1/bulletins`

## Request

- Base URL: `https://open.wenmarpro.com`
- URL: `https://open.wenmarpro.com/v1/bulletins`
- Auth: none declared

A make or a model the catalog does not have gives an empty list.

## Query parameters

- `make` string
- `model` string
- `year` integer
- `type` string
- `component` string
- `code` string
- `q` string
- `topic` string
- `limit` integer
- `cursor` string

## Response `200`

One page of bulletins.

- BulletinList: One page of bulletins, newest first.
  - `as_of` string, nullable
  - `attribution` string[], required
  - `bulletins` Bulletin[], required
    - `component` string, nullable: NHTSA's components, in its words, separated by `; `.
    - `date` string, nullable: The manufacturer's own date.
    - `date_added` string, required: The day NHTSA published it. Lists are ordered by it.
    - `document` BulletinDocument: Where NHTSA's copy of a bulletin's document is expected to be.
      - `alternate_url` string, required: The address to try when `url` answers "not found": NHTSA files documents under one of two endings, and the data does not say which.
      - `confirmed` boolean, required: Always `false`. The addresses are built from a rule that held for a sample of documents; this API has not asked NHTSA for this one.
      - `url` string, required: The likelier address of NHTSA's copy (a PDF).
    - `document_id` string, nullable: The manufacturer's own number for the document, which a dealer looks it up by.
    - `mfr_campaign` string, nullable: The manufacturer's campaign id or software version.
    - `nhtsa_id` integer, required: NHTSA's id number for the communication.
    - `summary` string, nullable: NHTSA's summary of the communication. The document itself is the manufacturer's and is not here.
    - `type` string, required: `service_bulletin`, `service_campaign`, `warranty_extension`, `over_the_air`, `emissions` or `other`.
    - `type_name` string, required: The type in words.
    - `url` string, required: The bulletin's page on this site.
  - `next_cursor` string, nullable
  - `note` string, required

## Other responses

- `400`: `validation_failed`: a query value is wrong, or `model` was given without `make`.
- `404`: `dataset_unavailable`: this server holds no bulletins.

---

[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)