List monitors in a project

GET

/projects/{project_id}/monitors

curl --request GET \
  --url https://api.perstat.io/projects/example/monitors \
  --header 'Authorization: Bearer <token>'

• Production

Returns all monitors of a project. Each entry includes the latest quorum-confirmed status and severity rather than the raw result of the last single check. Accepts API keys with the monitors:read scope, subject to current role and resource grants.

Authorizations

• bearer

Parameters

Path Parameters

project_id

required

string

Responses

200

Request succeeded. The response body contains the result.

Media typeapplication/json

Array<object>

object

alarm_gate

One of:

null

null

object

Abhaengige Alarme. Wie die Policy nur in der EINZELANSICHT gefuellt , in Listen bleibt sie weg, damit eine Monitor-Liste nicht je Zeile eine zweite Abfrage ausloest.

object

grace_seconds

required

integer format: int64

origins

required

Array<string>

archived

true while the monitor is archived: it runs no checks, appears in no list and does not count against the plan, but keeps its incidents and availability history. Set on the single-monitor read and in the answers of archive and restore; omitted elsewhere, since lists only ever hold active monitors.

boolean | null

config

required

enabled

required

boolean

id

required

string

interval_seconds

required

integer format: int32

last_severity

Severity des rohen jüngsten Checks (informativ; nicht für die Tönung).

string | null

last_status

Bestätigter Anzeige-Status für den Gesundheits-Punkt je Dienst: failed (rot) = offener Incident/Quorum-Ausfall, degraded (gelb) = unbestätigtes Problem (z. B. einzelner Vantage-Point), passed (grün). None = noch kein Check. Folgt damit derselben Logik wie Alarm/Push.

string | null

name

required

string

policy

One of:

null

null

object

Confirmation-Policy (Alarmprofil/Inline). Nur in der Einzelansicht gefüllt; in Listen None.

object

alarm_consecutive

integer | null format: int32

alarm_min_duration_seconds

Legacy per-monitor duration. A configured organization flow is the canonical effective source.

integer | null format: int32

alarm_quorum_mode

string | null

alarm_quorum_value

integer | null format: int32

alert_profile_id

string | null

effective_alarm

One of:

null

null

object

object

alarm_consecutive

required

integer format: int32

alarm_min_duration_seconds

integer | null format: int32

alarm_quorum_mode

required

string

alarm_quorum_value

required

integer format: int32

source

required

flow for configured editor flows, otherwise monitor_override or legacy.

string

failed_interval_seconds

integer | null format: int32

recovery_consecutive

integer | null format: int32

recovery_quorum_mode

string | null

recovery_quorum_value

integer | null format: int32

project_id

required

string

regions

required

Array<string>

slug

required

string

type

required

string

Example^generated

[
  {
    "alarm_gate": {
      "grace_seconds": 1,
      "origins": [
        "example"
      ]
    },
    "archived": true,
    "config": "example",
    "enabled": true,
    "id": "example",
    "interval_seconds": 1,
    "last_severity": "example",
    "last_status": "example",
    "name": "example",
    "policy": {
      "alarm_consecutive": 1,
      "alarm_min_duration_seconds": 1,
      "alarm_quorum_mode": "example",
      "alarm_quorum_value": 1,
      "alert_profile_id": "example",
      "effective_alarm": {
        "alarm_consecutive": 1,
        "alarm_min_duration_seconds": 1,
        "alarm_quorum_mode": "example",
        "alarm_quorum_value": 1,
        "source": "example"
      },
      "failed_interval_seconds": 1,
      "recovery_consecutive": 1,
      "recovery_quorum_mode": "example",
      "recovery_quorum_value": 1
    },
    "project_id": "example",
    "regions": [
      "example"
    ],
    "slug": "example",
    "type": "example"
  }
]

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.