Announcements

Getting Uptime Ratios Of Any Period Via API – Now Possible!

Written by Tomas Koprusak 143 words | 1 min read Updated Nov 13, 2025
0%

Since the release of the API, the “all time uptime ratio” for each monitor is provided by default.

Many users have asked for the ability to get weekly and/or monthly uptime ratios to integrate more values into their websites/apps.

Today, we have added a new variable to the getMonitors method which can return the uptime ratio of any given period.

It can provide values back to 2 months (this is how long the logs are kept for).

The new feature is smart enough to return the ratios of multiple intervals in a single API call.

In order to use it, just add: customUptimeRatio=7 to the getMonitors request for getting the 7 days uptime. Or you can go with customUptimeRatio=7-30-60 to get uptime ratios of all 3 days.

To learn more about the usage, just check the getMonitors method in the API docs.

Start using UptimeRobot today.

Join more than 2M+ users and companies!

  • Get 50 monitors for free - forever!
  • Monitor your website, server, SSL certificates, domains, and more.
  • Create customizable status pages.

Written by

Tomas Koprusak

Product Owner |

He has worked for Sygic as a marketer and co-led the implementation and development of a product acquired from a competitor. He has also worked as a freelance developer, helping clients from various areas. Tomas brings a wealth of industry experience to our team. He spent a few years in the blockchain industry, leading projects and marketing teams at multiple blockchain-based companies. He has presented products and managed deals in more than 10 countries around the world, managed the ICO, and built a successful marketing team at Fuergy that continues to thrive. Tomas managed a product team for the biggest job site in Slovakia, covering development and transformation to a new B2B app. Not only is Tomas skilled at web development, but he also has a deep understanding of SaaS businesses, which makes him an invaluable asset in shaping and leading various projects at UptimeRobot. His focus is always on the continual improvement of our service and user experience. In addition to his professional achievements, Tomas is a devoted father. His personal interests include cycling (he traveled around the whole country of Slovakia), playing guitar (he even played in a band), servicing bikes, music, and enjoying good beer.

Feature suggestions? Share

25 Comments

Aaron Sustar Feb 21, 2012 at 7:36 am

I just wanted to say that what you guys are doing is really great!

While we have a TON of in-house monitoring going on, it's always great to also have our websites and servers monitored by a 3rd party service. Keep it up, weI really appreciate it! :)

Damian Feb 25, 2012 at 8:16 am

Your site worked fine yesterday. Today when I login all that appears is this html error. Can you please fix this as soon as posible.

Microsoft OLE DB Provider for ODBC Drivers error '80040e21'

ODBC driver does not support the requested properties.

C:\INETPUB\UPTIMEROBOT.COM\INCLUDES\../includes/commonFunc.asp, line 930

Oliman Feb 25, 2012 at 10:07 pm

Where i can activate rss feed notification?

Tanks

alex Feb 27, 2012 at 10:17 am

where to check the IPS from uptimerobot to add them to my firewall, seems to be up-down-up-down-up-down one server. and i have same check but only with domain and 100% up.

admin Mar 1, 2012 at 5:04 am

@Aaron,
So great to see that the service helps.

@Damian,
We had a db issue and it is fixed as quickly as possible.

@Oliman,
The RSS feed is activated by default and can be found in the My Monitors page (just check the RSS icon).

@Alex,
The IPs can be found at: http://www.uptimerobot.com/about.asp

Thomas Mar 5, 2012 at 2:32 pm

Maybe I am not using the service correctly, but I took my server off line to rebuild after a failure, and the monitor shows that I am still at 100% uptime. I have it monitoring the home page.

Sveta Malinka Mar 22, 2012 at 1:53 pm

Thanks so much for this service. We have this so alerts go to my webmaster iPhone, then he setup an APP so that when he pushed the buttons, it resets our servers and C-Panel, even when traveling, we are never DOWM for long.

sirili Mar 28, 2012 at 10:47 am

You guys are great! Thank you for providing this service; it provides us with another way to monitor our web assets. Much appreciated.

admin Mar 29, 2012 at 4:52 am

@Thomas,
Please feel free to open a support ticket at support@uptimerobot.com and we can take a look at the issue.

@Sveta,
Awesome..

@sirili,
It is so motivating for us to see that the service helps.

Kim Apr 3, 2012 at 9:32 am

Thank you so much for this incredibly helpful service. I have a couple questions:

1) In the Status column, is that % for the last 24 hrs, or for all time (assuming "all time" means 2 months since that's how long as the logs are kept).

2) Is there any way to export the reports? If not, would you consider adding that feature at some point?

Thank you again. This service rocks! I appreciate it so much.

دنوج Apr 12, 2012 at 4:43 pm

Thanks for your nice site.
I use your service on may site.

admin Apr 16, 2012 at 12:22 am

@Kim,

1- They are all time (not 2 months either but since the beginning).
2- Export is not available yet but we'll add it with v2 (already working on it)

Hil May 5, 2012 at 11:21 am

I can monitor a website fine with HTTP Monitoring. But if I setup keyword monitoring for the same website then the keyword monitoring alerts says that the site is down

admin May 7, 2012 at 7:13 am

@Hil,

Keyword monitoring searches the text inside the HTML source code. Make sure the "keyword" is the same as it is in the keyword.

And also double-check if the "exists - not exists" option is selected right.

Please feel free to open a support ticket at @support@uptimerobot.com if the issue persists.

adel May 17, 2012 at 3:15 pm

Do your API support push monitoring? The web server that I would like to monitor is behind firewall and I would like to write code to use your api to provide you the status of of the web server every 5 minutes.
Thanks

admin May 19, 2012 at 10:03 pm

@adel,

That's a feature that we'd like to add so much but it is not available yet.

The only working solution for today would be to unblock the IPs used by Uptime Robot (can be found at: http://www.uptimerobot.com/about.asp).

Pascal Lichthart Jul 19, 2012 at 6:59 am

How can I add continue 24/7 monitoring?

It seems like it's just 24 Hrs?

admin Aug 27, 2012 at 7:30 am

It just shows the last 24 hours status but keeps monitoring 24/7.

Jeff3422 Nov 26, 2012 at 7:24 pm

Hi,
I'm using customUptimeRatio=1-14-30 to get the one day 2 weeks and one month availability of my web-site. But the returned ratio seems to be calculated from the oldest stored day i.e. the first day two months ago.
But I would need the availability from now back one day, from now back two weeks and from now back one month.
Does the API support this?
Kind regards, Jeff

admin Dec 11, 2012 at 9:18 am

@Jeff,

Actually, it should be working as you expect to. Is it still having the same issue?

hojjat Jan 9, 2013 at 4:20 pm

hi
i have a q
how i can show my uptime in my site as a public uptime?
thanks if you answer me

admin Jan 16, 2013 at 6:27 am

@hojjat,

Upscuits created by another Uptime Robot user can help: http://www.uptimerobot.com/api.asp#unofficialResources

Powermta Feb 3, 2016 at 5:02 pm

We have this so alerts go to my webmaster iPhone, then he setup an APP so that when he pushed the buttons, it resets our servers and C-Panel,

Elena May 10, 2016 at 9:27 am

How i get customUptimeRatio of 44 days ? like this : customUptimeRatio=44 ?
I have 44 logs obtained like this : logs=1. normal would that customUptimeRatio=44 for 44 logs, no ? How to show downtime with api like this : https://status.stripe.com/

Daniel Burbridge Oct 12, 2016 at 4:39 pm

Is it possible to retrieve uptime for a specifc period - for a specifc month / week / day for example?

Recent Articles

Recent Articles

What is an SLA?

What is an SLA?

SLAs often look like paperwork until something goes wrong. A service goes down, customers ask for credits, and teams scramble…

Table of Contents