County Feed API

Poll newly captured obituary notices for counties you enroll in the developer portal. This is a feed of recent deaths — not a person lookup or death-registry API.

Endpoint

GET /api/v1/county-feed/notices

Production URL: https://api.obituarymonitor.com/api/v1/county-feed/notices

Authenticate with Authorization: Bearer om_live_YOUR_KEY. Counties and delivery options are configured in the developer dashboard.

Query parameters

since

optional

ISO-8601 timestamp. Return notices with indexed_at at or after this value. Omit on first run, or pass pagination.next_since from your last response.

limit

optional

Page size between 1 and 1000. Default 500.

Example request

curl -sS \
  -H "Authorization: Bearer om_live_YOUR_KEY" \
  "https://api.obituarymonitor.com/api/v1/county-feed/notices?since=2026-05-01T00:00:00.000Z&limit=500"

GET https://api.obituarymonitor.com/api/v1/county-feed/notices?since=2026-05-01T00:00:00.000Z&limit=500
Authorization: Bearer om_live_YOUR_KEY

Example response

{
  "data": [
    {
      "id": "fh-88421",
      "full_name": "Margaret Ann Henderson",
      "first_name": "Margaret",
      "middle_name": "Ann",
      "last_name": "Henderson",
      "date_of_death": "2026-05-12",
      "county": "Jefferson",
      "state": "AL",
      "city": "Birmingham",
      "obituary_url": "https://example.com/obit/margaret-henderson",
      "funeral_home_name": "Example Funeral Home",
      "source_type": "funeral_home",
      "indexed_at": "2026-05-13T08:22:00.000Z",
      "text_snippet": "Margaret Ann Henderson, 84, of Birmingham, passed away on May 12, 2026…",
      "survivors_text": "She is survived by her son James Henderson and daughter Sarah Henderson."
    }
  ],
  "pagination": {
    "limit": 500,
    "has_more": false,
    "next_since": "2026-05-13T08:22:00.000Z"
  },
  "counties": [
    { "state": "AL", "county_slug": "jefferson-county-al", "county_name": "Jefferson" }
  ]
}

Pagination

The pagination object includes has_more, next_since, and limit. When has_more is true, request again immediately with since=next_since until the backlog is drained. Persist next_since between scheduled polls (once or twice daily is typical).

Response fields

Field	Description
id	Stable notice identifier
full_name	Display name from the source
first_name	Parsed first name when available
middle_name	Parsed middle name or initial when available
last_name	Parsed last name when available
date_of_death	YYYY-MM-DD when available
county	County name
state	Two-letter state code
city	City when available
obituary_url	Link to the obituary listing
funeral_home_name	Funeral home or newspaper publisher
source_type	funeral_home or newspaper
indexed_at	ISO timestamp when we first captured the notice
text_snippet	Short obituary excerpt when available
survivors_text	Best-effort survivors/family excerpt when available

Coverage rules

Notices must pass recency filters:

Date of death within the last 30 days
Date of death within 14 days of first capture (excludes historical backfill)

Absence from the feed is not proof of life. Sources include funeral homes and newspapers we monitor daily in enrolled counties.

Delivery alternatives

API pull — poll on your schedule (this endpoint).

Email digest — daily or weekly summary to configured recipients.

CSV archive — daily file of the previous calendar day (America/Chicago), downloadable from the dashboard for 30 days.

Error codes

Code	HTTP	Meaning
unauthorized	401	Missing, invalid, or revoked API key.
key_expired	401	The API key has passed its expiration date.
county_feed_access_required	403	County feed is not enabled on this account.
delivery_mode_email_only	403	API pull is disabled — account is configured for email digest delivery only.
internal_error	500	Unexpected server error.

Errors return { "error": { "code", "message" } }. An empty data array with HTTP 200 is not an error.