HOhoneycomb
Anomaly Detection

List All Signals

Changed on

List Signals in the environment associated with your API key. Signals are returned in cursor-paginated pages and can be filtered by service, dataset, kind, status, and whether they are currently anomalous.

get/1/signals

Request

  • Base URL
    https://api.honeycomb.io
  • URL
    https://api.honeycomb.io/1/signals
  • Auth
    API key in header X-Honeycomb-Team

Query parameters

page[after]string

The string value of the next attribute from a previous result page. The cursor value must be empty or omitted for the first request of a cursor-paginated query.

page[size]number

The number of entries to include per response. Maximum value is 100.

service_namestring

Restrict results to Signals for a single service.

dataset_slugstring

Restrict results to Signals in a single dataset.

measured_signal'error_rate' | 'presence'

The kind of measurement the Signal is trained on.

  • error_rate: The fraction of erroring requests for the service.
  • presence: Whether the service is producing spans.
Example:error_rate

Restrict results to Signals of the given kind.

status'onboarding' | 'normal' | 'anomalous' | 'ineligible' | 'off'

Restrict results to Signals in the given status.

When status is provided, it takes precedence over currently_anomalous.

currently_anomalousboolean

When true, only return Signals that are currently in an anomalous state.

This parameter is ignored when status is provided (use status=anomalous instead).

Response

Success

Example response

{
  "signals": [
    {
      "id": "hcasp_01j9x1yq0k2t8m9n3v4b5r6c7d",
      "service_name": "checkout-api",
      "dataset_slug": "checkout-api",
      "environment_slug": "production",
      "measured_signal": "error_rate",
      "enabled": true,
      "status": "normal",
      "sensitivity": "medium",
      "last_anomaly_started_at": 1741089600,
      "last_anomaly_ended_at": 1741093200,
      "created_at": "2025-02-14T17:32:11Z",
      "updated_at": "2025-03-01T10:04:22Z"
    }
  ],
  "links": {
    "next": "/2/teams/my-team/api-keys?page[after]=3025fa645ad1100d&page[size]=10"
  }
}

Changes