---
title: "Read Teensy Occurrences"
method: GET
path: "/api/v1/logs/teensy-occurrences"
tags: ["live logs"]
---

# Read Teensy Occurrences

`GET /api/v1/logs/teensy-occurrences`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/logs/teensy-occurrences`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `before` string, nullable
- `device_id` string, nullable
- `event_type` 'fault_raised' | 'fault_cleared' | 'condition_changed' | 'nack' | 'mcu_boot' | 'mcu_reset' | 'heartbeat_stalled' | 'heartbeat_recovered': Normalized MCU/edge events accepted from an enrolled dock device.
- `severity` 'info' | 'warning' | 'error' | 'critical'
- `event_code` string, nullable
- `edge_session_id` string, uuid, nullable

## Response `200`

Successful Response

- TeensyDiagnosticOccurrenceFeedResponse
  - `generated_at` string, date-time, required
  - `entries` TeensyDiagnosticOccurrenceResponse[], required
    - `occurrence_id` string, uuid, required
    - `device_id` string, required
    - `edge_session_id` string, uuid, required
    - `edge_sequence` integer, required
    - `observed_at` string, date-time, required
    - `received_at` string, date-time, required
    - `producer_service` string, required
    - `producer_pid` integer, required
    - `producer_instance_id` string, uuid, required
    - `io_mode` 'real' | 'fake', required
    - `dock_version` string, required
    - `teensy_firmware_version` string, nullable, required
    - `event_code` string, required
    - `event_type` 'fault_raised' | 'fault_cleared' | 'condition_changed' | 'nack' | 'mcu_boot' | 'mcu_reset' | 'heartbeat_stalled' | 'heartbeat_recovered', required: Normalized MCU/edge events accepted from an enrolled dock device.
    - `severity` 'info' | 'warning' | 'error' | 'critical', required
    - `nack_reason` string, nullable, required
    - `fault_codes` string[], required
    - `state_conditions` object, required
    - `message` string, required
    - `context` object, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)