---
title: "List signals"
method: GET
path: "/signals"
tags: ["Signals"]
---

# List signals

`GET /signals`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/signals`
- Auth: none declared

List a project's signals, newest first, filtered by type or creation time.

## Query parameters

- `projectId` string, uuid: Project to read signals for. Auto-filled from CLI and SDK context when omitted.
- `type` 'new_error': Filter by signal type.
- `createdAfter` string, date-time: Only signals created at or after this instant.
- `createdBefore` string, date-time: Only signals created before this instant.
- `limit` integer: Maximum number of signals to return per page.
- `cursor` string, uuid: Cursor from a previous response's nextCursor to fetch the next page.

## Response `200`

OK

- object
  - `signals` object[], required: Newest first.
    - `id` string, uuid, required: The signal's id.
    - `projectId` string, uuid, required
    - `createdAt` string, date-time, required: When the detector reported it.
    - `type` 'new_error', required
    - `payload` object, required: A `new_error` signal's payload: the error log itself.
      - `timestamp` string, date-time, required: When the customer's system emitted the error log.
      - `serviceName` string, nullable, required: The service that emitted the error log, when known.
      - `severity` string, nullable, required: The error log's severity, when known.
      - `body` string, required: The error log line as received, truncated to 8 KiB.
  - `nextCursor` string, uuid, nullable, required: Cursor to pass as 'cursor' to fetch the next page. Null when there are no more results.

## Changes

- **2026-10-26** `2cedb491eb92`: 1 info
  - endpoint added
- **2026-10-24** `965b6230cf45`: 1 breaking
  - api path removed without deprecation
- **2026-10-08** `ce96861cea60`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/signals/get.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/2cedb491eb92?raw)