# Uptime

Returns uptime information about:
- Hub with either one value or per-day granularity,
- Single group,
- Single service.

Uptime is calculated according to following rules:
- UTC timezone is used,
- 'degraded-performance' is not counted towards downtime. Only 'down'
  status is treated as time when service was down,
- If multiple events affect service in the same time, always worst
  status is being used for uptime calculation,
- For group uptime, combination of worst statuses of all services
  in that group is used.
  For example, if group has three services and:
  - One was up for the whole time,
  - Second was down for the whole first half of the period (50%),
  - Last service was down for the second half of the period (50%),
  then group uptime is 0% because there was no time when none of its
  services were down.
- For Hub uptime, combination of worst statuses of all services of that
  Hub is being used.


## Retrieve Hub uptime value

 - [GET /hubs/{subdomain}/uptime](https://api-docs.statushub.com/api-v3-openapi/uptime/getuptime.md): Returns uptime for a Hub which is based on uptime of all services
in that Hub for a given date range.
Hub is considered up if all of its services are not down.
Every time frame when at least one of Hub services is down, is considered
as downtime for this Hub.
Maximum length of date range is 18 months.

## Returns Hub uptime data with daily granularity

 - [GET /hubs/{subdomain}/uptime/daily](https://api-docs.statushub.com/api-v3-openapi/uptime/getdailyuptime.md): Returns uptime for a Hub with daily granularity.
Hub uptime is based on uptime of all services in that Hub for every
day.
Days are aligned to UTC timezone.
Hub is considered up for given day if all of its services are not down
in that day.
Every time frame when at least one of Hub services is down, is considered
as downtime for this Hub.
Maximum length of date range is 18 months.

## Retrieve group uptime value

 - [GET /hubs/{subdomain}/uptime/groups/{group_id}](https://api-docs.statushub.com/api-v3-openapi/uptime/getgroupuptime.md): Returns uptime for a group which is based on uptime of all services
in that group for a given date range.
Group is considered up if all of its services are not down.
Every time frame when at least one of group services is down, is considered
as downtime for this group.
Maximum length of date range is 18 months.

## Retrieve service uptime value

 - [GET /hubs/{subdomain}/uptime/services/{service_id}](https://api-docs.statushub.com/api-v3-openapi/uptime/getserviceuptime.md): Returns uptime for a service for a given date range.
Service is considered up its status is not down.
Maximum length of date range is 18 months.