API Reference · v1

DownRightNow API

A simple JSON REST API to query service status, incidents, history, and your account usage. All endpoints are read-only GETs and authenticate with an API key.

Get an API key →View plans

Authentication

Pass your key in the Authorization header on every request. Keys are issued per-account from your account API page. API access requires a Starter plan or higher.

curl https://downrightnow.app/api/v1/services \
  -H "Authorization: Bearer drn_..."

Rate limits

Two limits apply: a monthly quota set by your plan and a per-minute burst cap. Hitting either returns 429 Too Many Requests with a Retry-After header.

Plan	Per month	Per minute
Starter	500	60
Pro	5,000	120
Business	50,000	300
Enterprise	Custom	600+

Every response includes X-RateLimit-Remaining-Month and X-RateLimit-Remaining-Minute headers.

Errors

All errors return a JSON body with an error field.

401	Missing, malformed, or invalid API key.
403	Plan does not include API access.
404	Resource not found.
429	Rate limit exceeded — see Retry-After header.
500	Server error — please retry.

Services

GET/api/v1/services

List services

Returns every monitored public service with its current status.

Query parameters

limitinteger
Max results (default 100, max 500).
statusstring
Filter by current status (e.g. operational, degraded, down).

curl https://downrightnow.app/api/v1/services \
  -H "Authorization: Bearer drn_..."

GET/api/v1/services/{slug}

Get a service

Fetch a single service by slug.

curl https://downrightnow.app/api/v1/services/{slug} \
  -H "Authorization: Bearer drn_..."

GET/api/v1/services/{slug}/history

Service status history

Recent status snapshots — useful for uptime charts and trends.

Query parameters

hoursinteger
Lookback window (default 24, max 168).
limitinteger
Max snapshots (default 500, max 2000).

curl https://downrightnow.app/api/v1/services/{slug}/history \
  -H "Authorization: Bearer drn_..."

Incidents

GET/api/v1/services/{slug}/incidents

Incidents for a service

Active and recently-resolved incidents for one service.

Query parameters

limitinteger
Max incidents (default 20, max 100).
statusstring
Filter by 'active' or 'resolved'.

curl https://downrightnow.app/api/v1/services/{slug}/incidents \
  -H "Authorization: Bearer drn_..."

GET/api/v1/incidents/active

All active incidents

Every currently-active incident across all monitored services.

Query parameters

limitinteger
Max incidents (default 100, max 500).
severitystring
Filter by 'minor', 'major', or 'critical'.

curl https://downrightnow.app/api/v1/incidents/active \
  -H "Authorization: Bearer drn_..."

Custom services

GET/api/v1/custom-services

Your custom services

Lists the custom services you monitor on this account.

curl https://downrightnow.app/api/v1/custom-services \
  -H "Authorization: Bearer drn_..."

GET/api/v1/custom-services/{slug}/checks

Recent checks for a custom service

Latest check results for one of your custom services.

Query parameters

limitinteger
Max results (default 50, max 200).

curl https://downrightnow.app/api/v1/custom-services/{slug}/checks \
  -H "Authorization: Bearer drn_..."

Account

GET/api/v1/account/usage

Your API usage

Current month's request count and per-minute usage for your key.

curl https://downrightnow.app/api/v1/account/usage \
  -H "Authorization: Bearer drn_..."

GET/api/v1/account/plan

Your plan & limits

Current plan tier and the feature limits attached to it.

curl https://downrightnow.app/api/v1/account/plan \
  -H "Authorization: Bearer drn_..."