API Monitor Help & support
API Monitor app icon

How can we help?

Answers about adding endpoints, statuses, certificates, alerts and settings — and a direct line to the developer.

Questions14
Requires15macOS
AccountNone

Getting started3 questions

How do I add an endpoint?

Click + in the toolbar or press ⌘ N, then paste a URL. A single URL is test-checked while you type, so you see its status and response time before adding it. https:// is added when you leave it out.

You can also paste a whole list (one URL per line, or separated by spaces or commas), or drop links or a text file anywhere in the window.

Which URLs can I monitor?

Any HTTPS or HTTP address your Mac can reach: public APIs and websites, health endpoints with paths and query strings, custom ports, internal services over VPN, and local servers such as http://localhost:8080/health.

Can I import or export my list?

Yes. Use File → Import… (⌘ O) or File → Export… (⇧ ⌘ E). Lists are plain text with one URL per line; lines starting with # are ignored. When importing into an existing list, you choose whether to add the new URLs or replace the whole list.

Statuses & checks5 questions

What do the statuses mean?

  • Operational

    The last check succeeded within the response-time threshold.

  • Slow

    The endpoint responded, but slower than the threshold you set (1.5 s by default).

  • Unstable

    The last check failed, but not enough times in a row to call it down yet.

  • Down

    Several checks in a row have failed (2 by default). This is when you get a notification.

  • Pending

    A newly added endpoint that hasn't been checked yet.

How does a check work?

API Monitor sends a lightweight HEAD request. If the server rejects it with an error, the check is repeated with a GET, since many servers and firewalls don't allow HEAD. Only response headers are downloaded, never the body.

Any 2xx or 3xx response counts as up; redirects are followed. Response time is measured until the headers arrive.

What are uptime and the bars on a card?

The strip shows the latest checks: the taller the bar, the slower the response. Uptime is the share of successful checks among the last 120, which are kept between launches. Select an endpoint to see the full chart, average, P95, fastest and slowest response.

It works in my browser — why is it down here?

The app checks the URL without your browser's cookies or login. Common reasons:

  • The URL needs authorization and answers 401 or 403.
  • It is only reachable over a VPN or from another network.
  • A firewall or bot protection blocks automated requests.
  • The certificate is invalid or expired.

Tip: monitor a dedicated health endpoint that returns 200 without authorization.

How does the certificate expiry warning work?

For HTTPS endpoints, API Monitor reads the expiry date of the server's SSL certificate during a regular check — no extra requests are made. The date is shown in the inspector, and once the certificate is within the warning window (14 days by default) a yellow lock icon appears on the endpoint's card and row.

You get a notification when the certificate enters the warning window, then 7, 3 and 1 days before it expires and on the last day. After the certificate is renewed, the warnings start over. A certificate that has already expired fails the check and is shown as Certificate expired.

Alerts & menu bar3 questions

How do notifications work?

You get a notification when an endpoint goes Down, and another when it recovers, with how long it was down. You are also notified before an endpoint's SSL certificate expires. The Dock icon shows the number of endpoints that are down. If notifications don't appear, allow them in System Settings → Notifications → API Monitor. Each alert can be turned off in the app's Settings.

Does monitoring continue when I close the window?

Yes. While the status is shown in the menu bar, API Monitor keeps checking in the background, and the menu bar popover lists every endpoint with its status. Reopen the dashboard from there, or quit the app with its power button. If you hide the menu bar status in Settings, closing the window quits the app.

What happens when my Mac is offline?

Checks are skipped instead of being counted as failures, so you don't get false alarms. A banner on the dashboard says you're offline, and monitoring resumes on its own once the connection is back.

Settings3 questions

What can I adjust?

Open API Monitor → Settings… (⌘ ,) to set:

  • how often endpoints are checked — from 10 seconds to 5 minutes (15 seconds by default);
  • the request timeout — 3 to 30 seconds (10 by default);
  • when a response counts as slow, and after how many failed checks in a row an endpoint is down;
  • how early to warn about expiring certificates — 7, 14 or 30 days before expiry;
  • notifications, the theme (System, Light or Dark), the menu bar status and the Dock badge.

You can pause all checks with the toolbar button and clear the check history in Settings.

Keyboard shortcuts

  • ⌘N

    Add endpoint

  • ⌘R

    Check all now

  • ⇧⌘P

    Pause or resume monitoring

  • ⌘1 2

    Grid or list layout

  • ⌥⌘I

    Show or hide the inspector

  • ⌘F

    Search endpoints

  • ⌫

    Remove the selected endpoint

System requirements

A Mac with macOS 15 or later. Your list and check history are stored on your Mac only; see the Privacy Policy.

ContactWe read everything

Still need help?

Found a bug, have a question or an idea for API Monitor? Write to us — please include your macOS version and, if possible, the URL that behaves unexpectedly.

Email support