REST API Introduction

Overview

The Alert24 REST API lets you integrate incident management, monitoring, and status pages into your existing workflows programmatically. Every resource you can manage in the Alert24 dashboard is available through the API.

Base URL:

https://app.alert24.io/api/v1

Design Principles

• RESTful — Standard HTTP methods (GET, POST, PUT, DELETE) on resource URLs
• JSON everywhere — All request and response bodies are JSON
• Snake_case — All field names use snake_case
• ISO 8601 — All timestamps are ISO 8601 strings (e.g. 2026-03-19T14:30:00.000Z)
• Consistent envelopes — All responses wrapped in { data } or { data, meta } for lists
• Descriptive errors — Errors include a type, message, and status

Response Format

Single resource

{
  "data": {
    "id": "abc-123",
    "title": "Database outage",
    "status": "open",
    "created_at": "2026-03-19T14:30:00.000Z"
  }
}

List of resources

{
  "data": [
    { "id": "abc-123", "title": "Database outage" },
    { "id": "def-456", "title": "API latency spike" }
  ],
  "meta": {
    "total": 42,
    "limit": 25,
    "offset": 0,
    "has_more": true
  }
}

Errors

{
  "error": {
    "type": "validation_error",
    "message": "title is required",
    "status": 400
  }
}

Available Resources

Next Steps

1. Create an API key to get started
2. Follow the Quickstart guide to make your first API call
3. Explore individual resource docs for full field references