live24h REST API
The live24h API gives you programmatic access to all features of the platform. The API is available from the Pro plan.
Authentication
All API requests require an API key in the header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.live24h.eu/v1/checks
You can find your API key in your account settings under API Access.
Base URL
https://api.live24h.eu/v1/
Endpoints
Checks
| Method | Endpoint | Description |
|---|---|---|
GET | /checks | List all checks |
POST | /checks | Create a new check |
GET | /checks/{id} | Get check details |
PUT | /checks/{id} | Update a check |
DELETE | /checks/{id} | Delete a check |
GET | /checks/{id}/history | Get check history |
Status Pages
| Method | Endpoint | Description |
|---|---|---|
GET | /status-pages | List all status pages |
POST | /status-pages | Create a new status page |
GET | /status-pages/{id} | Status page details |
Incidents
| Method | Endpoint | Description |
|---|---|---|
GET | /incidents | List all incidents |
POST | /incidents | Create an incident |
PUT | /incidents/{id} | Update an incident |
Example: Create a Check
curl -X POST https://api.live24h.eu/v1/checks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Website",
"url": "https://www.example.com",
"type": "http",
"interval": 60,
"alertChannels": ["email"]
}'
Response Format
All responses are returned in JSON format:
{
"data": {
"id": "chk_abc123",
"name": "My Website",
"url": "https://www.example.com",
"status": "up",
"lastCheckedAt": "2025-01-15T10:30:00Z",
"responseTime": 245
}
}
Rate Limiting
The API is limited to 100 requests per minute. When exceeded, you will receive a 429 Too Many Requests status.
Error Handling
| Status | Meaning |
|---|---|
400 | Bad request |
401 | Missing or invalid authentication |
404 | Resource not found |
429 | Rate limit exceeded |
500 | Internal server error |