Get uptime percentage

GET

/api/v1/monitors/{id}/uptime

• Production

Returns the uptime percentage for a monitor over a specified number of hours.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

integer

Example

42

Unique monitor identifier.

Query Parameters

hours

integer

default: 24 >= 1

Example

24

Number of hours to calculate uptime over.

Responses

200

Uptime percentage for the specified period.

object

monitor_id

required

ID of the monitor.

integer

Example

42

hours

required

Number of hours covered.

integer

Example

24

percentage

required

Uptime percentage (0-100).

number format: double

Example

99.98

401

Authentication credentials are missing or invalid.

Error response returned when a request fails.

object

error

required

A human-readable error message.

string

Example

monitor not found

Example

{
  "error": "unauthorized"
}

404

The requested resource was not found.

Error response returned when a request fails.

object

error

required

A human-readable error message.

string

Example

monitor not found

Example

{
  "error": "not found"
}