Every request

What API monitoring checks on every request.

Each check is a real HTTP request. UptimeClaw records the status code and the response time. With the keyword check, it also confirms the response contains the text you expect.

So a broken deploy that still answers 200 with an error page shows up as a failure. The same goes for an endpoint that returns 401 because a token expired.

API monitoring check: a POST request with an Authorization header, then the status code, response text and response time are checked

Settings and what they catch

Every option on an HTTP check, with the failure it is there to catch.

SettingCatchesExample
MethodEndpoints that only answer one verbPOST /v1/orders/health
Request headersExpired or rejected credentialsAuthorization: Bearer ...
Request bodyValidation errors on real input{"ping": true}
Accepted status codesErrors and unexpected redirects200-299, or 200,201
Keyword in the responseA 200 that carries an error page"status":"ok"
Response timeSlowdowns before they become outagesRecorded on every check

Status code meanings follow the HTTP status reference.

Setup

Five minutes to your first API check.

Add an HTTP monitor with the endpoint URL, then open Advanced options.

  • Method. GET, POST, PUT, PATCH, DELETE or HEAD.
  • Headers. As JSON, for auth or an Accept header.
  • Body. The payload the endpoint expects.
  • Status codes. Ranges and lists, default 200-299.
  • Keyword. Choose the keyword type to require text in the response.

Checks run from Virginia on every plan, and from up to six locations on paid plans. See where we check from.

What you get

Built for the endpoints your app calls.

Real requests

Your method, headers and body

The check calls the endpoint the way your app does, so it fails when your app would.

Content

More than a status code

Require text in the response and catch the 200 that carries an error page.

Speed

Response time on every check

See when an endpoint is getting slower, with history on each monitor.

Locations

Checked from several places

Tell a regional problem from a global outage, with the location named in each alert.

Certificates

SSL expiry warnings

HTTPS endpoints get a warning before the certificate lapses.

Alerts

Where you will see them

Failures alert by email, WhatsApp, Telegram, Slack, Discord, Microsoft Teams, PagerDuty or a webhook.

Troubleshooting

The usual reasons an API check fails when the API looks fine.

SymptomLikely causeFix
401 or 403 on every checkToken expired, or headers are not valid JSONIssue a fresh read-only token and check the JSON quotes
405 Method Not AllowedThe endpoint does not accept that methodMatch the method your app uses
Fails on a redirectThe URL answers 301 or 302Use the final URL, or add the code to accepted status codes
Keyword check fails after a deployThe response wording changedUpdate the keyword to text that stays stable
Timeouts from one location onlyA regional network or CDN problemCheck the alert's location and the provider for that region

FAQ

Can I monitor an API that needs authentication?

Yes. Add request headers as JSON, for example an Authorization header with a bearer token. Use a read-only token made for monitoring.

Can it send POST, PUT or DELETE requests?

Yes. Choose GET, POST, PUT, PATCH, DELETE or HEAD, and add a request body when the endpoint needs one.

Does it check the response content?

With the keyword check, the response must contain a piece of text you choose, such as "status":"ok". It looks for the text in the response; it does not read individual JSON fields.

How often are APIs checked?

Every 5 minutes on the free plan, every 60 seconds on Solo, and every 30 seconds on Pro and Business.

Where are the checks made from?

From Virginia on every plan, and from up to six locations across the US, Europe and Asia on paid plans.

Can I manage monitors from code?

Yes. The UptimeClaw REST API creates, updates and pauses monitors, so they can live next to your deployment scripts.

Know before your users do.

API monitoring with real requests, free to start.

Related

Cron job monitoring · Response time monitoring · SSL monitoring · Multi-region monitoring · API docs