Playground: emails are not sent, payments are simulated.
Skip to content
isitup

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."
  }
}