API Documentation

Welcome to the Sorry™ REST API reference. We currently only offer one version of the API.

Using the Sorry™ API, you can create and configure your status pages, post new notices and much more. The references provided are guidance only, so please ensure you follow the correct endpoint instructions.

Base URL

The Sorry™ API is built on REST principles and requires HTTPS in every request for security and privacy. It does not support HTTP.

All requests contain the following base URL:

https://api.sorryapp.com/v1/

Rate limiting

The Sorry™ API enforces rate limiting to ensure fair usage and maintain service reliability for all users.

We currently allow 10 requests per second per API token. If you exceed this limit, you'll receive a 429 response. We recommend waiting before retrying your request.

Includes resources

Resources often have associations with one another.

For instance, a Page has a Brand, or a Notice has many Updates. You can request each of these separately, but it is easier to gather a collection of resources in one request using included resources.

https://api.sorryapp.com/v1/pages/f7c6d44d?include=brand

Deep nesting

You can nest include requests with the dot property. For example, requesting notices.updates on a page will consist of each notice and all their respective updates.

https://api.sorryapp.com/v1/pages/f7c6d44d?include=notices.updates

Including multiples

You can expand multiple objects at once by identifying multiple items in the include parameter separated by a comma, such as brand and notices.updates.

https://api.sorryapp.com/v1/pages/f7c6d44d?include=brand,notices.updates