Skip to content

developer

API reference

The public API currently documents one read endpoint for listing monitors. Runtime endpoints not listed here are not public API.

API v0.1.0JSON

Authentication

Use an API key with Authorization: Bearer on every request. Manage keys from the API keys page.

Every request and returned monitor is limited to the API key's tenant.

GET/v1/monitors

List monitors

Use limit from 1 through 200; the default is 100. Pass cursor from next_cursor to continue.

curl https://api.niceuptime.com/v1/monitors \
	  -H "Authorization: Bearer nu_live_your_token"

Rate limits

Free per minute: 60 req/minper second: 5 req/secdaily cap: 10,000/day
Pro per minute: 300 req/minper second: 20 req/secdaily cap: 100,000/day
Max per minute: 1,500 req/minper second: 50 req/secdaily cap: 1,000,000/day
RateLimit-Limit
RateLimit-Remaining
RateLimit-Reset
Retry-After

Errors

400invalid query parameter
401missing or invalid API key
429rate limited; retry after the supplied delay

Compatibility

v1 compatible changes preserve this documented endpoint. Breaking changes require a newly documented version.