One early-warning signal with identifiers

get/v1/signals/{id}

Request

  • Base URL: https://api.recallsapi.com
  • URL: https://api.recallsapi.com/v1/signals/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

idstring required

Response

OK

idstring
source'nhtsa_inv' | 'cpsc_nov' | 'globenewswire' | 'sec' | 'prop65' | 'spdb'

nhtsa_inv: NHTSA defect investigations; cpsc_nov: CPSC notices of violation; globenewswire: GlobeNewswire recall press releases (retired 2026-10-13; the 3 stored releases are kept); sec: SEC EDGAR 8-K filings; prop65: California Attorney General Proposition 65 60-day notices; spdb: CPSC SaferProducts.gov incident reports

kind'investigation' | 'violation' | 'press_release' | 'filing' | 'prop65_notice' | 'incident'
titlestring
summarystring nullable

Agency text for investigations and violation notices; for Prop 65 notices the chemicals, the product or source text, the case events, the statement that a notice is a private party's allegation, the AG accuracy disclaimer and the AG notice page; null for press releases and filings, which are stored as facts only (title, date, issuer or filer, link); for SaferProducts incident reports the product, category and incident state, then the CPSC database disclaimer and the statement that a report is a submission to CPSC, not a CPSC finding

firmsstring[]

Manufacturer, firm named in the notice, press release issuer, SEC filer or the alleged violators of a Prop 65 notice

productsstring[]

Investigations: the components under investigation, then the vehicles as make and model; violation notices: the product name; Prop 65 notices: the product or source text as the noticing party wrote it; empty for facts-only sources

signal_datestring date nullable

Date the investigation opened, the violation notice is dated, the filing was filed, the Prop 65 notice was filed with the AG or the incident report was submitted (its publication date when the report date is missing); for a stored GlobeNewswire release, the day it was published

end_datestring date nullable

Date an investigation closed; null while open and for other kinds

statusstring nullable

Investigations: open or closed. Violation notices: the action CPSC requested (Recall, Seize, Correct Future Production, Stop Sale and Correct Future Production). Prop 65 notices: notice, complaint, withdrawn or settled, from the case events the AG records. Null otherwise.

flagsstring[]

recall_campaign: the investigation led to at least one recall campaign (a campaign identifier names it); recall_requested: CPSC asked for a recall; facts_only: only title, date, issuer or filer and link are stored; allegation: a private party's notice, not a finding (Prop 65); submission: a SaferProducts.gov report, a submission to CPSC, not a CPSC finding

urlstring uri

Human page at the source

source_urlstring uri

Machine-readable file, feed or query we read

first_seenstring date-time
as_ofstring date-time

When recallsapi.com last saw this record change

Example response

{
  "id": "inv-PE26001"
}

Changes

No recorded changes to this operation across all 1 revision of this API.