This was a popular request from our users, and we’re happy to be able to add it to our list of features! You can find the feature at

https://www.testomato.com/api/project/[your project id]/uptime?end=[date]&start=[date](&apiKey=[your api key])

NOTE: you have to be logged in or use your api key for the project in order for the link to work

The new API endpoint will allow you to see a total of your uptime within a specified period of time. Up until now, you were able to see your total in uptime seconds — with this new addition, you’ll be able to see uptime in a percentage format. This is especially useful if you’re trying to build your own dashboard, need to get exact uptime data for a different system, or need more precise data in order to compile information about a project.

"uptime": {
  "up": 99.511294041242,
  "down": 0.19073763503692,
  "timeout": 0.29796832372145
}

Because the API endpoint is customizable, you can see your uptime for any period of your choice: a day, a week, a month. You do this by entering a start and end date. Please keep in mind that the dates need to be entered in two specific formats:

ISO8601 format OR unix timestamp format (numbers as before in milliseconds or seconds)

Here is an example:

?start=2019-03-16T00:00:00.000+01:00&end=2019-04-15T23:59:59.999+02:00

Valid date formats include:

  • 2019-03-16T00:00:00.000+01:00
  • 2019-03-16T00:00:00+01:00
  • 2019-03-16T00:00:00.000
  • 2019-03-16T00:00:00
  • You can read these examples this way:

First numbers are the DATE, then (after capital T) TIME, and last ones correspond to TIMEZONE SHIFT according to UTC time. This endpoint replaces the older status statusAggr ENTRYPOINT, which wasn’t public but still being used by some people.

The final response looks as follow:

UPTIME (up/down/timeout) shown in a percentage format and uptimeByDays (which contains all uptime data day by day).

"uptimeByDays": [
  {
    "date": "2019-04-01T00:00:00+02:00",
    "up": 99.579914088254,
    "down": 0.13953974187034,
    "timeout": 0.28054616987579
  },