---
title: "Retrieve API status"
method: GET
path: "/api/1.0/status"
tags: ["Status"]
---

# Retrieve API status

`GET /api/1.0/status`

Returns the current operational status of monitored Demand API endpoint groups and their individual endpoints.

## Headers

- `X-Partner-Id` string, required

## Response `200`

The operational status was retrieved successfully.

- StatusResponse — Response containing the current operational status of the monitored endpoint.
  - `data` GroupStatus[] — The operational status of each monitored endpoint group.
    - `group` string — The name of the endpoint group.
    - `status` 'up' | 'minor_outage' | 'major_outage' — The operational status of a monitored Demand API endpoint or endpoint group.
    - `updated_at` string, date-time — The UTC timestamp when the group status was last evaluated.
    - `since` string, date-time — The UTC timestamp indicating when the current issue affecting the group began. Present only when the status is not `up`.
    - `reason` string — A human-readable explanation of the current issue affecting the group. Present only when the status is not `up`.
    - `endpoints` EndpointStatus[] — The operational status of each monitored endpoint in the group.
      - `endpoint` string — The Demand API endpoint path.
      - `status` 'up' | 'minor_outage' | 'major_outage' — The operational status of a monitored Demand API endpoint or endpoint group.
      - `updated_at` string, date-time — The UTC timestamp when the endpoint status was last evaluated.
      - `since` string, date-time — Timestamp indicating when the current issue began. Present only when the status is not `up`.
      - `reason` string — Human-readable explanation of the current issue. Present only when the status is not `up`.

## Other responses

- `401` — Missing or invalid partner identifier.
- `403` — Your partner account is not authorised to access the Status API.
- `429` — Too many requests. The rate limit has been exceeded.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/booking/apis/status-api.md) · [All operations](https://skmtc.net/booking/apis/status-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/status-api/revisions/7ca336c58913/schema)