# Monitors — API reference

> The heart of the API: create, list, pause, resume and delete the things we check, as often as every ten seconds. REST endpoints with request and response fields, examples in curl, JavaScript, Python, Go and PHP, and an in-browser Try it console.

Source: https://upfour.io/docs/api/monitors

[Developers](https://upfour.io/docs/api.md)/Monitoring

The heart of the API: create, list, pause, resume and delete the things we check, as often as every ten seconds.

[The Monitor object](https://upfour.io/docs/api/monitors/get-a-monitor#returns) [In the app: Watch a website →](https://upfour.io/docs/watch-a-website.md)

Base URL `https://app.upfour.io/v1`. Send your key as `Authorization: Bearer <key>`; every key acts on your real Company, so [test without paging anyone](https://upfour.io/docs/api/testing.md). New here? Start with the [quickstart](https://upfour.io/docs/api/quickstart.md). The examples read the key from `UP4_API_KEY`.

## Everyday

[GET **List monitors** /monitors](https://upfour.io/docs/api/monitors/list-monitors.md)[POST **Create a monitor** /monitors](https://upfour.io/docs/api/monitors/create-a-monitor.md)[GET **Get a monitor** /monitors/{monitorID}](https://upfour.io/docs/api/monitors/get-a-monitor.md)[PATCH **Update a monitor** /monitors/{monitorID}](https://upfour.io/docs/api/monitors/update-a-monitor.md)[PUT **Replace a monitor** /monitors/{monitorID}](https://upfour.io/docs/api/monitors/replace-a-monitor.md)[DEL **Delete a monitor** /monitors/{monitorID}](https://upfour.io/docs/api/monitors/delete-a-monitor.md)

## Control

[POST **Pause a monitor** /monitors/{monitorID}/pause](https://upfour.io/docs/api/monitors/pause-a-monitor.md)[POST **Resume a monitor** /monitors/{monitorID}/resume](https://upfour.io/docs/api/monitors/resume-a-monitor.md)[POST **Run a check now** /monitors/{monitorID}/check](https://upfour.io/docs/api/monitors/run-a-check-now.md)[POST **Send a test alert** /monitors/{monitorID}/test-alert](https://upfour.io/docs/api/monitors/send-a-test-alert.md)

## Results and history

[GET **List check results** /monitors/{monitorID}/results](https://upfour.io/docs/api/monitors/list-check-results.md)[GET **Get availability** /monitors/{monitorID}/availability](https://upfour.io/docs/api/monitors/get-availability.md)[GET **Get response times** /monitors/{monitorID}/response_times](https://upfour.io/docs/api/monitors/get-response-times.md)[GET **List incidents** /monitors/{monitorID}/incidents](https://upfour.io/docs/api/monitors/list-incidents.md)[GET **List certificates** /monitors/{monitorID}/certificates](https://upfour.io/docs/api/monitors/list-certificates.md)[GET **Get domain expiry** /monitors/{monitorID}/domain-expiry](https://upfour.io/docs/api/monitors/get-domain-expiry.md)[GET **List regions** /monitors/{monitorID}/regions](https://upfour.io/docs/api/monitors/list-regions.md)[GET **Get the summary** /monitors/summary](https://upfour.io/docs/api/monitors/get-the-summary.md)

## Alerting

[GET **List alert channels** /monitors/{monitorID}/notification_channels](https://upfour.io/docs/api/monitors/list-alert-channels.md)[POST **Attach an alert channel** /monitors/{monitorID}/notification_channels/{channelID}](https://upfour.io/docs/api/monitors/attach-an-alert-channel.md)[DEL **Detach an alert channel** /monitors/{monitorID}/notification_channels/{channelID}](https://upfour.io/docs/api/monitors/detach-an-alert-channel.md)[PUT **Set the alert plan** /monitors/{monitorID}/escalation-policy](https://upfour.io/docs/api/monitors/set-the-alert-plan.md)[DEL **Remove the alert plan** /monitors/{monitorID}/escalation-policy](https://upfour.io/docs/api/monitors/remove-the-alert-plan.md)

## Many at once

[POST **Import monitors** /monitors/batch](https://upfour.io/docs/api/monitors/import-monitors.md)[POST **Preview an import** /monitors/batch/dry-run](https://upfour.io/docs/api/monitors/preview-an-import.md)[GET **List imports** /monitors/batch/history](https://upfour.io/docs/api/monitors/list-imports.md)[POST **Change several monitors** /monitors/bulk](https://upfour.io/docs/api/monitors/change-several-monitors.md)[POST **Export monitors** /monitors/export-details](https://upfour.io/docs/api/monitors/export-monitors.md)
