Developers

Evinor API Documentation

Manage sensors programmatically and receive signed webhooks when incidents match your sensors — from your first API key to your first delivered event.

Get started→API reference

Welcome to the developer documentation for the Evinor public REST API. Use it to manage sensors programmatically and receive signed webhooks when incidents match your sensors.

• Base URL: https://api.evinor.ai
• Transport: HTTPS only
• Authentication: a bearer API key on every request

Start here

• Getting Started — create an API key and make your first request in minutes.
• Authentication — key format, headers, scopes, and rotation.

Conventions

• Errors — the RFC 9457 problem format every error uses.
• Rate limits — the per-key request budget and its headers.
• Pagination — cursor-based paging on list endpoints.
• Idempotency — safely retry writes with an idempotency key.
• Versioning & deprecation — how the API evolves under /v1.

Guides

• Receiving webhooks — verify and consume signed sensor deliveries.
• Searching events — query the historical event corpus (a billed endpoint).
• Beats — save a set of clauses and poll the events that match them, with no webhook to host.

API reference

The complete, interactive endpoint reference — request and response schemas, per-language code samples, and a built-in "try it" console — lives at API Reference.