Hedera Status API

Overview

The Hedera Status API enables programmatic access to the current operational status, incident reports, and scheduled maintenance for the Hedera network. This API is especially useful for developers and system operators who want to integrate real-time status updates into their applications or monitor system health programmatically.

Key Features

  • Real-time Status Updates: Retrieve the current operational state of all Consensus Nodes.

  • Incident Reports: Access detailed information about current and past incidents, including affected components and resolution status.

  • Scheduled Maintenance: Get advance notice and real-time updates on planned maintenance windows.

Base URL

The base URL for all endpoints is:

https://status.hedera.com/api/v2

Endpoints

Endpoint
Description

GET /summary.json

Get a summary of the status page, including a status indicator, component statuses, unresolved incidents, and any upcoming or in-progress scheduled maintenance.

GET /status.json

Get the status rollup for the whole page. This endpoint includes an indicator - one of none, minor, major, or critical, as well as a human description of the blended component status.

Examples of the blended status include "All Systems Operational," "Partial System Outage," and "Major Service Outage."

GET /components.json

List all components. Each component is listed along with its status - one of operational, degraded_performance, partial_outage, or major_outage.

GET /incidents.json

Get a list of the 50 most recent incidents. This includes all unresolved incidents as described above, as well as those in the Resolved and Postmortem state.

GET /incidents/unresolved.json

Get a list of any unresolved incidents. This endpoint will only return incidents in the Investigating, Identified, or Monitoring state.

GET /scheduled-maintenances.json

Get a list of the 50 most recent scheduled maintenance. This includes scheduled maintenance as described in the above two endpoints, as well as those in the Completed state.

GET /scheduled-maintenances/upcoming.json

Get a list of any upcoming maintenance. This endpoint will only return scheduled maintenances still in the Scheduled state.

GET /scheduled-maintenances/active.json

Get a list of any active maintenance. This endpoint will only return scheduled maintenance in the In Progress or Verifying state.

Retrieve a summary of the status page.

get

Get a summary of the status page, including a status indicator, component statuses, unresolved incidents, and any upcoming or in-progress scheduled maintenances.

Responses
200
A JSON object containing the summary of the status page.
application/json
get
GET /api/v2/summary.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing the summary of the status page.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "status": {
    "description": "text",
    "indicator": "text"
  },
  "components": {
    "id": "text",
    "name": "text",
    "status": "text",
    "created_at": "2025-06-23T03:49:33.816Z",
    "updated_at": "2025-06-23T03:49:33.816Z",
    "description": "text",
    "group": true,
    "group_id": "text",
    "only_show_if_degraded": true,
    "position": 1,
    "showcase": true,
    "start_date": "2025-06-23T03:49:33.816Z",
    "page_id": "text"
  },
  "incidents": {
    "id": "text",
    "name": "text",
    "status": "text",
    "impact": "text",
    "created_at": "2025-06-23T03:49:33.816Z",
    "updated_at": "2025-06-23T03:49:33.816Z",
    "resolved_at": "2025-06-23T03:49:33.816Z",
    "monitoring_at": "2025-06-23T03:49:33.816Z",
    "incident_updates": [
      {
        "id": "text",
        "incident_id": "text",
        "status": "text",
        "body": "text",
        "created_at": "2025-06-23T03:49:33.816Z",
        "updated_at": "2025-06-23T03:49:33.816Z",
        "display_at": "2025-06-23T03:49:33.816Z"
      }
    ],
    "components": [
      {
        "id": "text",
        "name": "text",
        "status": "text",
        "created_at": "2025-06-23T03:49:33.816Z",
        "updated_at": "2025-06-23T03:49:33.816Z",
        "description": "text",
        "group": true,
        "group_id": "text",
        "only_show_if_degraded": true,
        "position": 1,
        "showcase": true,
        "start_date": "2025-06-23T03:49:33.816Z",
        "page_id": "text"
      }
    ]
  },
  "scheduled_maintenances": {
    "id": "text",
    "name": "text",
    "status": "text",
    "impact": "text",
    "created_at": "2025-06-23T03:49:33.816Z",
    "updated_at": "2025-06-23T03:49:33.816Z",
    "resolved_at": "2025-06-23T03:49:33.816Z",
    "monitoring_at": "2025-06-23T03:49:33.816Z",
    "scheduled_for": "2025-06-23T03:49:33.816Z",
    "scheduled_until": "2025-06-23T03:49:33.816Z",
    "shortlink": "https://example.com",
    "incident_updates": [
      {
        "id": "text",
        "incident_id": "text",
        "status": "text",
        "body": "text",
        "created_at": "2025-06-23T03:49:33.816Z",
        "updated_at": "2025-06-23T03:49:33.816Z",
        "display_at": "2025-06-23T03:49:33.816Z"
      }
    ],
    "components": [
      {
        "id": "text",
        "name": "text",
        "status": "text",
        "created_at": "2025-06-23T03:49:33.816Z",
        "updated_at": "2025-06-23T03:49:33.816Z",
        "description": "text",
        "group": true,
        "group_id": "text",
        "only_show_if_degraded": true,
        "position": 1,
        "showcase": true,
        "start_date": "2025-06-23T03:49:33.816Z",
        "page_id": "text"
      }
    ]
  }
}

Retrieve the current status of the Hedera network

get

Fetches the overall status and health indicators of the Hedera network.

Responses
200
A JSON object containing the current status and page information.
application/json
get
GET /api/v2/status.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing the current status and page information.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "status": {
    "description": "text",
    "indicator": "text"
  }
}

List all components

get

Provides detailed information about each component of the Hedera network.

Responses
200
A JSON object containing the status of all components.
application/json
get
GET /api/v2/components.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing the status of all components.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "components": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "description": "text",
      "group": true,
      "group_id": "text",
      "only_show_if_degraded": true,
      "position": 1,
      "showcase": true,
      "start_date": "2025-06-23T03:49:33.816Z",
      "page_id": "text"
    }
  ]
}

Retrieve all incidents

get

Fetches a list of all incidents, both resolved and unresolved, affecting the Hedera network.

Responses
200
A JSON object containing all incidents.
application/json
get
GET /api/v2/incidents.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing all incidents.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "incidents": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "impact": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "resolved_at": "2025-06-23T03:49:33.816Z",
      "monitoring_at": "2025-06-23T03:49:33.816Z",
      "incident_updates": [
        {
          "id": "text",
          "incident_id": "text",
          "status": "text",
          "body": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "display_at": "2025-06-23T03:49:33.816Z"
        }
      ],
      "components": [
        {
          "id": "text",
          "name": "text",
          "status": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "description": "text",
          "group": true,
          "group_id": "text",
          "only_show_if_degraded": true,
          "position": 1,
          "showcase": true,
          "start_date": "2025-06-23T03:49:33.816Z",
          "page_id": "text"
        }
      ]
    }
  ]
}

Retrieve unresolved incidents

get

Provides information about all currently unresolved incidents affecting the Hedera network.

Responses
200
A JSON object containing unresolved incidents.
application/json
get
GET /api/v2/incidents/unresolved.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing unresolved incidents.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "incidents": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "impact": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "resolved_at": "2025-06-23T03:49:33.816Z",
      "monitoring_at": "2025-06-23T03:49:33.816Z",
      "incident_updates": [
        {
          "id": "text",
          "incident_id": "text",
          "status": "text",
          "body": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "display_at": "2025-06-23T03:49:33.816Z"
        }
      ],
      "components": [
        {
          "id": "text",
          "name": "text",
          "status": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "description": "text",
          "group": true,
          "group_id": "text",
          "only_show_if_degraded": true,
          "position": 1,
          "showcase": true,
          "start_date": "2025-06-23T03:49:33.816Z",
          "page_id": "text"
        }
      ]
    }
  ]
}

Retrieve all scheduled maintenances

get

Fetches details about all scheduled maintenance events for the Hedera network.

Responses
200
A JSON object containing all scheduled maintenances.
application/json
get
GET /api/v2/scheduled-maintenances.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing all scheduled maintenances.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "scheduled_maintenances": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "impact": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "resolved_at": "2025-06-23T03:49:33.816Z",
      "monitoring_at": "2025-06-23T03:49:33.816Z",
      "scheduled_for": "2025-06-23T03:49:33.816Z",
      "scheduled_until": "2025-06-23T03:49:33.816Z",
      "shortlink": "https://example.com",
      "incident_updates": [
        {
          "id": "text",
          "incident_id": "text",
          "status": "text",
          "body": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "display_at": "2025-06-23T03:49:33.816Z"
        }
      ],
      "components": [
        {
          "id": "text",
          "name": "text",
          "status": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "description": "text",
          "group": true,
          "group_id": "text",
          "only_show_if_degraded": true,
          "position": 1,
          "showcase": true,
          "start_date": "2025-06-23T03:49:33.816Z",
          "page_id": "text"
        }
      ]
    }
  ]
}

Retrieve upcoming scheduled maintenances

get

Provides information about all upcoming scheduled maintenance events for the Hedera network.

Responses
200
A JSON object containing upcoming scheduled maintenances.
application/json
get
GET /api/v2/scheduled-maintenances/upcoming.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing upcoming scheduled maintenances.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "scheduled_maintenances": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "impact": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "resolved_at": "2025-06-23T03:49:33.816Z",
      "monitoring_at": "2025-06-23T03:49:33.816Z",
      "scheduled_for": "2025-06-23T03:49:33.816Z",
      "scheduled_until": "2025-06-23T03:49:33.816Z",
      "shortlink": "https://example.com",
      "incident_updates": [
        {
          "id": "text",
          "incident_id": "text",
          "status": "text",
          "body": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "display_at": "2025-06-23T03:49:33.816Z"
        }
      ],
      "components": [
        {
          "id": "text",
          "name": "text",
          "status": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "description": "text",
          "group": true,
          "group_id": "text",
          "only_show_if_degraded": true,
          "position": 1,
          "showcase": true,
          "start_date": "2025-06-23T03:49:33.816Z",
          "page_id": "text"
        }
      ]
    }
  ]
}

Retrieve active scheduled maintenances

get

Fetches details about all currently active scheduled maintenance events for the Hedera network.

Responses
200
A JSON object containing active scheduled maintenances.
application/json
get
GET /api/v2/scheduled-maintenances/active.json HTTP/1.1
Host: status.hedera.com
Accept: */*
200

A JSON object containing active scheduled maintenances.

{
  "page": {
    "id": "text",
    "name": "text",
    "url": "https://example.com",
    "time_zone": "text",
    "updated_at": "2025-06-23T03:49:33.816Z"
  },
  "scheduled_maintenances": [
    {
      "id": "text",
      "name": "text",
      "status": "text",
      "impact": "text",
      "created_at": "2025-06-23T03:49:33.816Z",
      "updated_at": "2025-06-23T03:49:33.816Z",
      "resolved_at": "2025-06-23T03:49:33.816Z",
      "monitoring_at": "2025-06-23T03:49:33.816Z",
      "scheduled_for": "2025-06-23T03:49:33.816Z",
      "scheduled_until": "2025-06-23T03:49:33.816Z",
      "shortlink": "https://example.com",
      "incident_updates": [
        {
          "id": "text",
          "incident_id": "text",
          "status": "text",
          "body": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "display_at": "2025-06-23T03:49:33.816Z"
        }
      ],
      "components": [
        {
          "id": "text",
          "name": "text",
          "status": "text",
          "created_at": "2025-06-23T03:49:33.816Z",
          "updated_at": "2025-06-23T03:49:33.816Z",
          "description": "text",
          "group": true,
          "group_id": "text",
          "only_show_if_degraded": true,
          "position": 1,
          "showcase": true,
          "start_date": "2025-06-23T03:49:33.816Z",
          "page_id": "text"
        }
      ]
    }
  ]
}

Additional Resources

For further integration support or detailed documentation on all available endpoints, visit the official Hedera Status API page.

Last updated

Was this helpful?