# AngelCam event API

**Canonical:** https://apis.io/apis/angelcam/angelcam-event-api/  
**Provider:** AngelCam — https://apis.io/providers/angelcam/  
**Base URL:** https://api.angelcam.com/v1  
**Documentation:** https://developers.angelcam.com/

AngelCam event API is one of 29 APIs that [AngelCam](https://apis.io/providers/angelcam/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Event. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and rate-limit docs.

Events represent detections reported by cameras or sensors — typically motion detected by a camera or a trigger from an external sensor. Events are the building blocks for [RTS incidents](#tag/incidents) and camera timeline markers. ## Sending events to Angelcam When a camera or sensor detects something, it reports it to Angelcam by calling the event endpoint with its unique `hash` (found in the Angelcam dashboard or via the [Sensor](#tag/sensor) endpoints). Use `POST /v1/events/` in all cases where possible. A `GET /v1/events/` alternative exists solely for devices that are technically incapable of making POST requests (some older cameras). The rate limit for event submission is 10 requests per minute per hash. ## Listing events Pagination for event list endpoints works differently from other list endpoints: there is no `offset` parameter. Instead: - Use the `next` link in the response to move to the next page. - Pagination is one-directional (forward only). - Use the `start` and `end` filters to narrow down the time range. Events are returned ordered by `occurred_at` (newest first).

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/cameras/{camera_id}/events/` | Retrieve camera event list |
| POST | `/events/` | Create event |
| GET | `/events/` | Create event by get request |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/openapi/angelcam-event-api-openapi.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/authentication/angelcam-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/scopes/angelcam-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/conventions/angelcam-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/errors/angelcam-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/rate-limits/angelcam-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/lifecycle/angelcam-lifecycle.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/data-model/angelcam-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/conformance/angelcam-conformance.yml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/agentic-access/angelcam-agentic-access.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/asyncapi/angelcam-webhooks.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/arazzo/angelcam-watch-live-camera.yml
- **Arazzo** — https://raw.githubusercontent.com/api-evangelist/angelcam/refs/heads/main/arazzo/angelcam-create-and-share-clip.yml

## Other AngelCam APIs (12)

- [AngelCam active-service API](https://apis.io/apis/angelcam/angelcam-active-service-api/)
- [AngelCam angelcameras API](https://apis.io/apis/angelcam/angelcam-angelcameras-api/)
- [AngelCam arrow-clients API](https://apis.io/apis/angelcam/angelcam-arrow-clients-api/)
- [AngelCam audio-message API](https://apis.io/apis/angelcam/angelcam-audio-message-api/)
- [AngelCam broadcasting API](https://apis.io/apis/angelcam/angelcam-broadcasting-api/)
- [AngelCam camera API](https://apis.io/apis/angelcam/angelcam-camera-api/)
- [AngelCam camera-guest API](https://apis.io/apis/angelcam/angelcam-camera-guest-api/)
- [AngelCam camera-stream-detection API](https://apis.io/apis/angelcam/angelcam-camera-stream-detection-api/)
- [AngelCam client API](https://apis.io/apis/angelcam/angelcam-client-api/)
- [AngelCam clip API](https://apis.io/apis/angelcam/angelcam-clip-api/)
- [AngelCam incidents API](https://apis.io/apis/angelcam/angelcam-incidents-api/)
- [AngelCam location API](https://apis.io/apis/angelcam/angelcam-location-api/)

## Tags

Event

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/angelcam/angelcam-event-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/angelcam/.