API overview

Neopresenter exposes a clean REST API for developers who want to integrate the platform with their own tools.

Authentication

All API requests use bearer-token authentication. Generate a token from Settings → Developers → API keys.

curl https://api.neopresenter.app/v1/sermons \
  -H "Authorization: Bearer np_live_..."

Rate limits

• Plant: 100 requests / hour
• Parish: 5,000 requests / hour
• Cathedral: 50,000 requests / hour + burst capacity

Each response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Resources

• GET /v1/sermons — List sermons in your library
• GET /v1/sermons/:id — Fetch a single sermon with full transcript
• GET /v1/broadcasts — List past and current broadcasts
• POST /v1/broadcasts/:id/start — Start a broadcast programmatically
• GET /v1/analytics/viewers — Aggregate viewer metrics
• GET /v1/destinations — Manage broadcast destinations

Webhooks

Subscribe to platform events from Settings → Developers → Webhooks. Available events:

• broadcast.started — A live stream went on-air
• broadcast.ended — A live stream finished
• sermon.published — A new sermon was published to your library
• verse.detected — The AI detected a scripture reference (high-volume — filter carefully)
• transcription.completed — A sermon's transcript is ready

Webhooks are signed with HMAC-SHA256 and retried up to 5 times with exponential backoff.