FiveNines

Public REST API

Manage your entire monitoring setup programmatically. Create servers, configure uptime monitors, deploy workflows, and query incidents - all through a RESTful JSON API with token-based authentication. Automate onboarding, integrate with your CI/CD pipeline, or build custom tooling.

Start Free - 5 Servers

No credit card required · 2-minute setup

How It Works

Generate Token

Create an API token from your account settings.

Make Requests

Standard REST with JSON bodies and Bearer token auth.

Manage Resources

Full CRUD for servers, monitors, workflows, incidents, and more.

Automate

Script your setup, spin up monitors in CI/CD, build internal tools.

Full CRUD for Every Resource

Servers, uptime monitors, workflows, incidents, tasks, network devices, status pages, and integrations. If you can do it in the UI, you can do it via the API.

Token Auth With Revocation

Bearer token authentication. Generate multiple tokens for different integrations. Revoke any token instantly without affecting others.

OpenAPI Documentation

Full Swagger/OpenAPI spec at /api-docs. Auto-generated client libraries, interactive API explorer, and request/response examples.

API Examples

List your servers with a single curl command:

curl -H 'Authorization: Bearer YOUR_API_TOKEN' \
  https://fivenines.io/api/v1/instances

Create an uptime monitor:

curl -X POST https://fivenines.io/api/v1/uptime_monitors \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com",
    "check_interval": 60,
    "name": "Production Website"
  }'

Build Internal Tooling

The API is designed for automation. Common use cases:

  • CI/CD integration: Automatically create uptime monitors when deploying new services
  • Infrastructure provisioning: Add servers to monitoring as part of your Ansible/Terraform pipeline
  • Custom dashboards: Pull metrics and incident data into your own internal tools
  • Bulk operations: Script the creation of monitors, workflows, and alert channels for new environments

How It Compares

Approach Full CRUD Token Auth Terraform OpenAPI Docs Cost
Manual UI N/A N/A N/A Varies
Competitor APIs Partial Some Varies Varies
FiveNines API Built-in Included

API access included on all plans

No additional cost

Frequently Asked Questions

How does API authentication work?
Generate an API token from your account settings. Include it as a Bearer token in the Authorization header of every request. Tokens can be revoked at any time.
What resources can I manage via the API?
The API covers servers (instances), uptime monitors, workflows and versions, incidents, tasks (cron jobs), network devices, status pages, integrations, and API tokens. Full CRUD operations are available for most resources.
Is there rate limiting?
Yes. API requests are rate-limited to prevent abuse. Current limits are generous for normal automation use cases. If you hit a limit, the response includes a Retry-After header.
Does the API support webhooks?
Yes. You can configure webhook integrations that fire on events like incident creation, resolution, or host status changes. Webhooks are configured through the integrations API or the UI.
Is there an OpenAPI specification?
Yes. The API is documented with an OpenAPI (Swagger) specification available at /api-docs. You can use it to generate client libraries in any language.

Related Features

Terraform Provider

Prefer declarative infrastructure-as-code? The Terraform provider wraps this API.

Custom Dashboards

Build dashboards in the UI or manage them programmatically via the API.

Monitoring Workflows

Create and manage workflow automations through the API.

See how FiveNines compares: vs Better Stack · vs HetrixTools

Start automating your monitoring setup

Start Free - 5 Servers

Free tier includes 5 servers - no credit card required

Read the API documentation