April 17, 2019 by Diana Bocco

NEW TESTOMATO FEATURE: API Endpoint “Uptime”

Testomato now offers a new API endpoint called “uptime.” Find out why you’ll love this new feature!

NEW TESTOMATO FEATURE: API Endpoint “Uptime”

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
  },

Is your website available? Testomato can check your website availability every 15 seconds from 10 different locations around the world and will send you an alert if the site is unavailable.

Keep track of the important parts of your website with simple checks that can run every minute. They can check plain words, HTML code, HTTP headers, redirects … and much more. Never miss anything.

Websites break, it happens all time. You'll be the first to know. Testomato has an extensive database of and will let you know if it finds any error on monitored url.