isitup API v1.0.0
The isitup REST API lets you manage monitors and read check results, incidents and status pages for your account. It speaks JSON over HTTPS and is available on every plan.
Authentication. Create a token under App > API and send it as Authorization: Bearer <token>. A token is bound to one account; every request is scoped to that account, so resources belonging to other accounts answer 404.
Rate limits. 120 requests per minute per token. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (epoch seconds). Exceeding the limit returns 429 with a Retry-After header.
Pagination. List endpoints accept page and per_page (default 25, maximum 100; check results default 100, maximum 1000). The response body has meta and links; the same information is sent in the Link, X-Page, X-Per-Page, X-Total-Count and X-Total-Pages headers.
Errors. Every error has the same shape: {"error": {"code", "status", "message", "details"}}. details maps field names to messages for validation errors.
Quick start
Base URL: https://isitup.app/api/v1
export ISITUP_TOKEN="iiu_..." # create one under App > API
curl -H "Authorization: Bearer $ISITUP_TOKEN" https://isitup.app/api/v1/account
Account
The account the token belongs to.
Get the current account
get /account
Returns the account of the token with its plan limits and current usage.
Example
curl "https://isitup.app/api/v1/account" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The account.
{
"data": {
"id": 42,
"name": "Acme Inc.",
"plan": "pro",
"timezone": "Europe/Berlin",
"created_at": "2026-01-12T09:30:00.000Z",
"limits": {
"monitors": 200,
"min_interval_seconds": 30,
"status_pages": 5,
"browser_checks": 5,
"seats": 5,
"history_days": 365
},
"usage": {
"monitors": 12,
"status_pages": 1,
"browser_checks": 0
}
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Monitors
Create, change, pause and delete monitors. Plan limits and validations match the web app.
List monitors
get /monitors
Parameters
| page | query, integer | Page number, starting at 1. |
| per_page | query, integer | Items per page (default 25, maximum 100). |
| status | query, string (pending, up, down, paused) | Only monitors with this status. |
| kind | query, string (http, keyword, ssl, domain, heartbeat, spam, form, checkout, indexing) | Only monitors of this kind. |
| url | query, string | Only monitors with exactly this URL (or hostname for domain monitors). |
| q | query, string | Case-insensitive search in the monitor name. |
Example
curl "https://isitup.app/api/v1/monitors" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 A page of monitors, oldest first.
{
"data": [
{
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
],
"meta": {
"page": 1,
"per_page": 1,
"total": 1,
"pages": 1
},
"links": {
"first": "https://example.com/",
"prev": "https://example.com/",
"next": "https://example.com/",
"last": "https://example.com/"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Create a monitor
post /monitors
Subject to the plan's monitor count, minimum check interval and browser check limits; violations are reported as validation_failed (422) with the same messages as the web app. Heartbeat monitors need no url; the response contains the URL your job must ping.
Request body (JSON)
| name | string | |
| kind | MonitorKind | http checks a URL, keyword also looks for text, ssl and domain watch certificate and domain expiry, heartbeat expects a ping from your job, form and checkout are browser checks limited by plan. |
| url | string | http(s) URL; hostname for domain monitors; not needed for heartbeat monitors. |
| interval_seconds | integer | Must be at least the plan's minimum (60 s Free |
| timeout_ms | integer | |
| http_method | string (GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS) | |
| expected_status | integer | |
| keyword | string | Required for keyword monitors. |
| keyword_should_exist | boolean | |
| regions | array of string (eu-fra, us-nyc, ap-sgp) |
Example
curl -X POST "https://isitup.app/api/v1/monitors" \
-H "Authorization: Bearer $ISITUP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Marketing site","kind":"http","url":"https://example.com","interval_seconds":60}'
Responses
201 The created monitor.
{
"data": {
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
422 The record is invalid or a plan limit was hit.
{
"error": {
"code": "validation_failed",
"status": 422,
"message": "Validation failed: Interval seconds must be at least 60 seconds on the Free plan",
"details": {
"interval_seconds": [
"must be at least 60 seconds on the Free plan"
]
}
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Get a monitor
get /monitors/{id}
Parameters
| id | path, integer, required | Monitor id. |
Example
curl "https://isitup.app/api/v1/monitors/101" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The monitor.
{
"data": {
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Update a monitor
patch /monitors/{id}
Send only the attributes you want to change.
Parameters
| id | path, integer, required | Monitor id. |
Request body (JSON)
| name | string | |
| kind | MonitorKind | http checks a URL, keyword also looks for text, ssl and domain watch certificate and domain expiry, heartbeat expects a ping from your job, form and checkout are browser checks limited by plan. |
| url | string | http(s) URL; hostname for domain monitors; not needed for heartbeat monitors. |
| interval_seconds | integer | Must be at least the plan's minimum (60 s Free |
| timeout_ms | integer | |
| http_method | string (GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS) | |
| expected_status | integer | |
| keyword | string | Required for keyword monitors. |
| keyword_should_exist | boolean | |
| regions | array of string (eu-fra, us-nyc, ap-sgp) |
Example
curl -X PATCH "https://isitup.app/api/v1/monitors/101" \
-H "Authorization: Bearer $ISITUP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Marketing site (EU)","interval_seconds":120}'
Responses
200 The updated monitor.
{
"data": {
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
422 The record is invalid or a plan limit was hit.
{
"error": {
"code": "validation_failed",
"status": 422,
"message": "Validation failed: Interval seconds must be at least 60 seconds on the Free plan",
"details": {
"interval_seconds": [
"must be at least 60 seconds on the Free plan"
]
}
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Delete a monitor
delete /monitors/{id}
Permanently deletes the monitor with its check results and incidents.
Parameters
| id | path, integer, required | Monitor id. |
Example
curl -X DELETE "https://isitup.app/api/v1/monitors/101" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
204 Deleted.
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Pause a monitor
post /monitors/{id}/pause
Stops checks and alerts until the monitor is resumed. Pausing a paused monitor is a no-op.
Parameters
| id | path, integer, required | Monitor id. |
Example
curl -X POST "https://isitup.app/api/v1/monitors/101/pause" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The paused monitor.
{
"data": {
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Resume a monitor
post /monitors/{id}/resume
Schedules an immediate check. Resuming a monitor that is not paused is a no-op.
Parameters
| id | path, integer, required | Monitor id. |
Example
curl -X POST "https://isitup.app/api/v1/monitors/101/resume" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The resumed monitor (status `pending` until the first check).
{
"data": {
"id": 101,
"name": "Marketing site",
"kind": "http",
"url": "https://example.com",
"status": "up",
"interval_seconds": 60,
"timeout_ms": 10000,
"http_method": "GET",
"expected_status": 200,
"keyword": null,
"keyword_should_exist": true,
"regions": [],
"last_checked_at": "2026-11-16T07:00:12.000Z",
"last_response_ms": 187,
"uptime_30d": 99.982,
"ssl_expires_at": null,
"domain_expires_at": null,
"paused_at": null,
"created_at": "2026-10-01T10:00:00.000Z",
"updated_at": "2026-11-16T07:00:12.000Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
422 The record is invalid or a plan limit was hit.
{
"error": {
"code": "validation_failed",
"status": 422,
"message": "Validation failed: Interval seconds must be at least 60 seconds on the Free plan",
"details": {
"interval_seconds": [
"must be at least 60 seconds on the Free plan"
]
}
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Check results
Individual check results of a monitor.
List check results of a monitor
get /monitors/{id}/check_results
Newest first. Without from/to the last 24 hours are returned. The window never reaches back further than the plan's history (30 days on Free, 365 days on Pro and Agency).
Parameters
| id | path, integer, required | Monitor id. |
| page | query, integer | Page number, starting at 1. |
| per_page | query, integer | Results per page (default 100, maximum 1000). |
| from | query, string | Start of the time range, ISO 8601 (default to minus 24 hours). |
| to | query, string | End of the time range, ISO 8601 (default now). |
| region | query, string | Only results from this check region. |
| outcome | query, string (success, failure) |
Example
curl "https://isitup.app/api/v1/monitors/101/check_results" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 A page of check results.
{
"data": [
{
"id": 9001,
"monitor_id": 101,
"region": "eu-fra",
"outcome": "success",
"response_ms": 187,
"http_status": 200,
"error_message": null,
"checked_at": "2026-11-16T07:00:12.000Z"
}
],
"meta": {
"page": 1,
"per_page": 1,
"total": 1,
"pages": 1,
"monitor_id": 1,
"from": "2026-01-01T00:00:00Z",
"to": "2026-01-01T00:00:00Z"
},
"links": {
"first": "https://example.com/",
"prev": "https://example.com/",
"next": "https://example.com/",
"last": "https://example.com/"
}
}
400 A parameter or the request body is malformed (`invalid_parameter`, `invalid_json`, `parameter_missing`).
{
"error": {
"code": "invalid_parameter",
"status": 400,
"message": "Parameter 'from' must be an ISO 8601 timestamp, e.g. 2026-01-31T12:00:00Z",
"details": {
"from": [
"must be an ISO 8601 timestamp, e.g. 2026-01-31T12:00:00Z"
]
}
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Incidents
Downtime incidents opened by failed checks.
List incidents
get /incidents
Incidents of all monitors in the account, newest first.
Parameters
| page | query, integer | Page number, starting at 1. |
| per_page | query, integer | Items per page (default 25, maximum 100). |
| status | query, string (open, resolved) | |
| monitor_id | query, integer |
Example
curl "https://isitup.app/api/v1/incidents" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 A page of incidents.
{
"data": [
{
"id": 1,
"monitor_id": 1,
"monitor_name": "string",
"status": "open",
"cause": "string",
"confirmed_regions": [
"string"
],
"started_at": "2026-01-01T00:00:00Z",
"resolved_at": "2026-01-01T00:00:00Z",
"acknowledged_at": "2026-01-01T00:00:00Z",
"duration_seconds": 1
}
],
"meta": {
"page": 1,
"per_page": 1,
"total": 1,
"pages": 1
},
"links": {
"first": "https://example.com/",
"prev": "https://example.com/",
"next": "https://example.com/",
"last": "https://example.com/"
}
}
400 A parameter or the request body is malformed (`invalid_parameter`, `invalid_json`, `parameter_missing`).
{
"error": {
"code": "invalid_parameter",
"status": 400,
"message": "Parameter 'from' must be an ISO 8601 timestamp, e.g. 2026-01-31T12:00:00Z",
"details": {
"from": [
"must be an ISO 8601 timestamp, e.g. 2026-01-31T12:00:00Z"
]
}
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Get an incident
get /incidents/{id}
Parameters
| id | path, integer, required |
Example
curl "https://isitup.app/api/v1/incidents/101" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The incident.
{
"data": {
"id": 1,
"monitor_id": 1,
"monitor_name": "string",
"status": "open",
"cause": "string",
"confirmed_regions": [
"string"
],
"started_at": "2026-01-01T00:00:00Z",
"resolved_at": "2026-01-01T00:00:00Z",
"acknowledged_at": "2026-01-01T00:00:00Z",
"duration_seconds": 1
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Status pages
Read-only access to your status pages.
List status pages
get /status_pages
Parameters
| page | query, integer | Page number, starting at 1. |
| per_page | query, integer | Items per page (default 25, maximum 100). |
Example
curl "https://isitup.app/api/v1/status_pages" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 A page of status pages.
{
"data": [
{
"id": 1,
"title": "string",
"slug": "string",
"description": "string",
"public": true,
"custom_domain": "string",
"monitor_ids": [
1
],
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}
],
"meta": {
"page": 1,
"per_page": 1,
"total": 1,
"pages": 1
},
"links": {
"first": "https://example.com/",
"prev": "https://example.com/",
"next": "https://example.com/",
"last": "https://example.com/"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}
Get a status page
get /status_pages/{id}
Parameters
| id | path, integer, required |
Example
curl "https://isitup.app/api/v1/status_pages/101" \
-H "Authorization: Bearer $ISITUP_TOKEN"
Responses
200 The status page.
{
"data": {
"id": 1,
"title": "string",
"slug": "string",
"description": "string",
"public": true,
"custom_domain": "string",
"monitor_ids": [
1
],
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}
}
401 The token is missing, unknown or revoked.
{
"error": {
"code": "unauthorized",
"status": 401,
"message": "Missing, invalid or revoked API token. Send 'Authorization: Bearer <token>'."
}
}
404 The resource does not exist or belongs to another account.
{
"error": {
"code": "not_found",
"status": 404,
"message": "Resource not found."
}
}
429 Too many requests; wait `Retry-After` seconds.
{
"error": {
"code": "rate_limited",
"status": 429,
"message": "Rate limit exceeded. Retry in 23 seconds."
}
}