Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
      1. Monitors API
        1. List monitors GET
        2. Get monitor GET
        3. Monitor response times GET
        4. Monitor availability GET
        5. Create monitor POST
        6. Update monitor PATCH
        7. Remove monitor DELETE
        8. Response attributes
      2. Monitor groups API
    3. Heartbeats
    4. On-call & incidents
    5. Status pages
    6. Metadata
    7. Integrations

Monitor availability

Returns availability summary for a specific monitor.

GET https://uptime.betterstack.com/api/v2/monitors/{monitor_id}/sla

URL parameters

monitor_id
required string

The ID of the monitor you want to get

Query parameters

from
string

Start date (e.g., 2021-01-26)

to
string

End date (e.g., 2021-01-27)

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the availability summary since the monitor was created or for the specified date range.


The values of total_downtime, longest_incident, and average_incident are in seconds

Response body

{
  "data": {
    "id": "258338",
    "type": "monitor_sla",
    "attributes": {
      "availability": 99.98,
      "total_downtime": 600,
      "number_of_incidents": 3,
      "longest_incident": 300,
      "average_incident": 200
    }
  }
}
400

When the optional from and to dates are invalid (e.g., the start date is in the future or the end date is before the start date).

Response body

{
  "errors": "The data range is invalid. The date format could not be parsed, the start time is in the future, or the end time is after the start time."
}

Example cURL

Example
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/monitors/123456789/sla?from=2021-01-26&to=2021-01-27 \
  --header "Authorization: Bearer $TOKEN"

Previous article

Monitor response times

Next article

Create monitor