# Status page feeds, badge and widget

> Show your status page's state in your app, docs or README, and follow it in Slack: JSON, RSS and Atom feeds, an SVG badge and a one-line widget.

Every public status page can be read from outside StatusTick. Replace `<slug>` with your page's address (the part after `/status/`). Hidden pages return 404 everywhere.

## JSON

```
https://api.statustick.com/v1/pages/<slug>
```

The overall status, each component with its status and uptime, and open and recent incidents. No login is needed, any website may read it (CORS is open), and answers are cached for a short time.

## RSS and Atom

```
https://api.statustick.com/v1/pages/<slug>/feed.rss
https://api.statustick.com/v1/pages/<slug>/feed.atom
```

One entry per incident update and per maintenance state, with the affected components. Add either URL to a feed reader or a chat tool that follows feeds.

## Status updates in Slack

People who follow your status page can get its updates in a Slack channel through the RSS feed:

1. On the status page, open **Get updates** and pick the **Slack** tab.
2. Copy the RSS feed URL shown there.
3. In the Slack channel, type `/feed subscribe` followed by that URL:

```
/feed subscribe https://api.statustick.com/v1/pages/<slug>/feed.rss
```

Slack then posts each incident update and each maintenance state to the channel once, with the affected components.

What to expect:

- Posts are plain feed posts.
- The channel gets updates for the whole page. You cannot pick single components.
- Each update is a new post. Earlier posts are not edited in place.
- Slack decides how often it reads the feed, so a post can arrive some minutes after the update.
- StatusTick cannot count the people who follow a page in Slack, so they are not in your subscriber numbers.

The Slack tab is not shown on password-protected pages, on team pages, or when the page has its feeds turned off.

## Badge

```markdown
![Status](https://api.statustick.com/v1/pages/<slug>/badge.svg)
```

An SVG badge with the page's status. For one component use `https://api.statustick.com/v1/pages/<slug>/components/<component id>/badge.svg`. Add `?label=api` to change the left text.

## Widget

```html
<script src="https://api.statustick.com/v1/pages/<slug>/widget.js" async></script>
```

Shows a small notice such as "All systems operational" where you put the tag, linked to your status page. Add `data-theme="dark"` to the tag for dark backgrounds. The script sets no cookies and sends no credentials.
