NAYBORLEE FOR DEVELOPERS

Put useful local plans where people can find them.

A county-level Happenings API for public activities, with source attribution and a review step. Built for providers and publishers who serve real local communities.

↙

Read

Retrieve up to 30 published upcoming happenings for a five-digit US county FIPS code.

↗

Submit

Approved sources can submit dated public activities. Every update returns to review before publication.

Public read endpoint

GET /api/happenings?county=13121

Returns a county code and a happenings array, including title, summary, time, broad location, source, public URL, and sponsored disclosure when applicable. Empty results are possible; coverage is not yet populated.

Source submission

POST /api/happenings
Authorization: Bearer <source-token>
X-Nayborlee-Source: <approved-site-slug>

Send a unique source event ID, five-digit county FIPS, title, summary, ISO 8601 start time, location label, and HTTPS event URL. An accepted request returns 202 pending, not a live listing. Tokens are issued individually after review; there is no self-serve key issuance yet.

Boundaries and access

Only public, dated activities belong in this feed. No private posts, member identities, exact home locations, or attendance data.
Sponsored submissions require separate authorization and appear with a visible label.
Expect a source review, usage limits, and a published API agreement before production access.

Build with us

Describe your public activity source, service area, and integration plan. We’ll review it before issuing credentials.

Apply for API access ↗