Health Check

Communicate real-time status to your users


This feature is available on Business and Enterprise plans.

It's important to let your users know when your API or product is having stability issues or downtime. ReadMe allows you to show a notification to your users if that's the case. This can be accessed in your dash by going to General Settings > Health Check.

There are two different types of health check that we currently support:

1. Manual Update

You manually tell us whether your API is healthy or not, optionally providing a status URL which we'll link to your users to get further details. You let your users know of your API status by logging into your ReadMe account and updating the toggle.


Screenshot showing manual health check provider.

2. Sync

If you already have a status page setup at, you can select this and give us your "page ID." You can grab your page ID from the URL when you're administering your status page. It is the part at the end of the URL:

Once you give us that, we'll periodically check Statuspage's API to make sure your page isn't reporting any issues.


Screenshot showing health check provider.

What it Looks Like On the Hub

We display an alert to your issues when we detect that your API is having issues. If you provided us with a URL (for manual) we link to it. If you're using, we automatically fetch your URL from the API.


Screenshot showing unhealthy alert on the front end.

Did this page help you?