UK Bereavement Notification Registry API v1.0.0

Bereavement contact information for 909 UK service providers — open data, no authentication required

909
Organisations
292
Categories
68
Corporate groups
No key
Authentication

Endpoints

GET /api/healthz Service health check — status, version, total organisations
GET /api/v1/organisations List all organisations — paginated, searchable, filterable ?q=?category=?sub_category=?tell_us_once=?parent_group=?urgency=
GET /api/v1/organisations/{slug} Single organisation by slug — e.g. barclays, hmrc, aviva
GET /api/v1/categories All category / sub-category combinations with counts (292 distinct)
GET /api/v1/groups Corporate groups with member counts and single-notification contact details
GET /api/v1/urgency-tiers Notification urgency tiers (Critical / High / Medium / Low) with recommended timeframes and live org counts
API Reference Docs OpenAPI JSON Usage stats

Quick start

curl <base-url>/api/healthz
curl "<base-url>/api/v1/organisations/barclays"
curl "<base-url>/api/v1/organisations?category=Pension&per_page=50"
curl "<base-url>/api/v1/organisations?q=aviva"
curl "<base-url>/api/v1/organisations?tell_us_once=Yes"
curl "<base-url>/api/v1/organisations?urgency=tier_1_critical"
curl "<base-url>/api/v1/categories"
curl "<base-url>/api/v1/groups"
curl "<base-url>/api/v1/urgency-tiers"

Pagination & filters

List endpoints support ?page= (default 1) and ?per_page= (default 20, max 100). Every response includes a meta object with total, page, per_page, and total_pages, plus a links object with self, first, last, next, and prev URLs. Filters on /v1/organisations: ?q (full-text search), ?category, ?sub_category, ?tell_us_once, ?parent_group, ?urgency.

Error format

{ "errors": [{ "code": "not_found", "title": "Not Found", "detail": "..." }] }

GDS-standard error envelope. HTTP status codes: 200, 404, 422, 500.

Standards & licence

Built to the UK Government Digital Service API Technical and Data Standards (July 2024). REST • JSON • URI versioning (/v1/) • Structured GDS errors • Page-based pagination • Cache-Control headers • ETag on single-item responses • X-Request-ID tracing • CORS open for GET.

Licensed under the Open Government Licence v3.0.