List active Darwin alarms

GET

/v1/operations/alarms

const url = 'https://api.headcode.dev/v1/operations/alarms?limit=20&offset=0';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.headcode.dev/v1/operations/alarms?limit=20&offset=0' \
  --header 'Authorization: Bearer <token>'

Returns active (non-cleared) Darwin alarms for operational monitoring.

Authorizations

bearerAuth

Parameters

Query Parameters

limit

integer

default: 20 <= 100

offset

integer

Responses

200

List of active alarms.

application/json

object

alarms

required

Array<object>

object

alarm_id

required

Unique identifier for the alarm.

string

kind

required

Type/category of the alarm.

string

td_area_id

TD area associated with the alarm, if applicable.

string | null

raised_at

required

When the alarm was raised.

string format: date-time

cleared

required

Whether the alarm has been cleared.

boolean

cleared_at

When the alarm was cleared, if applicable.

string | null format: date-time

total

required

Total number of active alarms.

integer

Example ^generated

{
  "alarms": [
    {
      "alarm_id": "example",
      "kind": "example",
      "td_area_id": "example",
      "raised_at": "2026-04-15T12:00:00Z",
      "cleared": true,
      "cleared_at": "2026-04-15T12:00:00Z"
    }
  ],
  "total": 1
}

401

API key is missing or invalid.

application/problem+json

Unauthorized

Authentication is missing or invalid.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/unauthorized

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Unauthorized

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 401

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.UNAUTHORIZED

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "missing or malformed Bearer token",
  "code": "HEADCODE.GENERAL.UNAUTHORIZED"
}

403

API key does not have the required scope.

application/problem+json

Forbidden

The API key does not have the required scope.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/forbidden

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Forbidden

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 403

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.FORBIDDEN

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "API key does not have the required scope 'reference:read'.",
  "code": "HEADCODE.GENERAL.FORBIDDEN"
}

429

The client has exceeded its rate limit.

application/problem+json

Too Many Requests

The client has sent too many requests in a given amount of time.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/rate-limited

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Too Many Requests

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 429

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.RATE_LIMITED

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 30 seconds.",
  "code": "HEADCODE.GENERAL.RATE_LIMITED"
}

500

An unexpected internal error occurred.

application/problem+json

Internal Server Error

An internal error occurred.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/internal-server-error

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Internal Server Error

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 500

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

Allowed value: An internal error occurred.

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.INTERNAL_SERVER_ERROR

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/internal-server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An internal error occurred.",
  "code": "HEADCODE.GENERAL.INTERNAL_SERVER_ERROR"
}

List active Darwin alarms

Authorizations

Parameters

Query Parameters

Responses

200

Example generated

401

Example

403

Example

429

Example

500

Example

Example ^generated