REST API

API Quickstart

Get Started in 30 Seconds

1. Create an API key

Go to Settings → API Keys in your Alert24 dashboard and create a new key. Copy the full key — it's only shown once.

Your key will look like: ak_live_A1b2C3d4E5f6G7h8...

2. Make your first request

List your incidents:

curl -s https://app.alert24.io/api/v1/incidents \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" | jq

3. Create an incident

curl -s https://app.alert24.io/api/v1/incidents \
  -X POST \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Database connection pool exhausted",
    "severity": "high",
    "status": "open"
  }' | jq

Response:

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "incident_number": 42,
    "title": "Database connection pool exhausted",
    "severity": "high",
    "status": "open",
    "source": "api",
    "created_at": "2026-03-19T14:30:00.000Z"
  }
}

4. Update the incident

curl -s https://app.alert24.io/api/v1/incidents/INCIDENT_ID \
  -X PUT \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "resolved",
    "resolved_at": "2026-03-19T15:00:00.000Z"
  }' | jq

5. List your services

curl -s https://app.alert24.io/api/v1/services \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE" | jq

Common Patterns

Pagination

All list endpoints support limit and offset query parameters:

curl "https://app.alert24.io/api/v1/incidents?limit=10&offset=20" \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE"

Filtering

Filter by field values using query parameters:

# Only critical incidents
curl "https://app.alert24.io/api/v1/incidents?severity=critical" \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE"

# Only active monitoring checks
curl "https://app.alert24.io/api/v1/monitoring?status=active" \
  -H "Authorization: Bearer ak_live_YOUR_KEY_HERE"

Next Steps

← REST API IntroductionAuthentication →