/v1/safety-events/changesWhat changed in FDA recalls and shortages, newest first. Each change includes the full record, the time we first saw it and FDA’s own dates.
AuthorizationstringRequiredBearer token with your API key. Keep the key server-side.
Idempotency-KeystringOptionalMakes a retry count once. 8 to 128 letters, digits and . _ : / + -, starting with a letter or digit. For 24 hours the key is bound to your workspace and the exact request; reusing it for different work is refused with 409.
Values go in the query string; repeat a field to send several values.
sincestringOptionalat least 10 characters · at most 40 charactersChanges first seen at or after this time (inclusive): a date, YYYY-MM-DD, which is midnight UTC so the whole day is kept, or an ISO date-time with a zone.
familystring or array of stringOptionalrecalls or shortages. Repeat for both; leave it out for both.
record_idstringOptionalat most 100 charactersOne record’s changes: the record_id of an earlier change, or a recall number such as D-0645-2024 for every product of that recall. An ID no record carries is 404; one from a family you did not ask for is 400.
limitintegerOptionalDefaults to 20min 1 · max 100Changes per page.
cursorstringOptionalThe cursor from the previous page of this same feed.
One object. Optional fields are left out when empty; a few return null for unknown, as their sentences say. Dates are YYYY-MM-DD and times ISO 8601 UTC.
familiesarray of ChangeFamilyRequiredCoverage of each family you asked for with family, or both without it: status, start and the time changes are complete through.
changesarray of SafetyEventChangeRequiredThe changes, newest first.
Errors and limits lists every code and the limits behind them.