Status API

Access Lodum system status data programmatically. Get real-time service status, uptime metrics, and incident reports via our REST API.

API Endpoints

GET/api/status

Get current status of all services

Example Request:

curl https://lodumai.com/api/status

Response:

{
  "status": "operational",
  "timestamp": "2024-03-12T17:08:00Z",
  "services": [
    {
      "name": "API Gateway",
      "status": "operational",
      "uptime": "99.99%",
      "responseTime": 85,
      "lastChecked": "2024-03-12T17:07:30Z"
    }
  ]
}
GET/api/status/history

Get historical status data for the last 30 days

Example Request:

curl https://lodumai.com/api/status/history

Response:

{
  "period": "30d",
  "services": [
    {
      "name": "API Gateway",
      "uptime": "99.99%",
      "incidents": 0,
      "downtime": 0
    }
  ]
}
GET/api/status/incidents

Get recent incidents and their status

Example Request:

curl https://lodumai.com/api/status/incidents

Response:

{
  "incidents": [
    {
      "id": "incident_123",
      "title": "API Gateway Latency Issues",
      "status": "resolved",
      "severity": "medium",
      "createdAt": "2024-01-15T10:00:00Z",
      "resolvedAt": "2024-01-15T10:32:00Z",
      "duration": "32 minutes"
    }
  ]
}
GET/api/status/metrics

Get detailed performance metrics

Example Request:

curl https://lodumai.com/api/status/metrics

Response:

{
  "metrics": {
    "overallUptime": "99.98%",
    "avgResponseTime": 85,
    "totalRequests": 1250000,
    "errorRate": 0.01
  },
  "services": [
    {
      "name": "API Gateway",
      "responseTime": {
        "p50": 85,
        "p95": 150,
        "p99": 250
      },
      "requests": {
        "total": 500000,
        "success": 499950,
        "errors": 50
      }
    }
  ]
}

Code Examples

JavaScript/Node.js

const response = await fetch('https://lodumai.com/api/status');
const data = await response.json();

if (data.status === 'operational') {
  console.log('All systems operational');
} else {
  console.log('Some services affected');
}

Python

import requests

response = requests.get('https://lodumai.com/api/status')
data = response.json()

if data['status'] == 'operational':
    print('All systems operational')
else:
    print('Some services affected')

cURL

curl -X GET \
  https://lodumai.com/api/status \
  -H "Accept: application/json"

PHP

$response = file_get_contents('https://lodumai.com/api/status');
$data = json_decode($response, true);

if ($data['status'] === 'operational') {
    echo 'All systems operational';
} else {
    echo 'Some services affected';
}

HTTP Status Codes

200

Request successful

The API request was processed successfully

429

Rate limited

Too many requests. Please wait before retrying

500

Server error

Internal server error. Please try again later

Rate Limits

Free

1000/hour
  • Basic status data
  • Current status only
  • Community support

Pro

10000/hour
  • Full status data
  • Historical data
  • Webhooks
  • Priority support

Enterprise

Unlimited
  • All features
  • Custom endpoints
  • SLA guarantee
  • Dedicated support

Webhooks

Status Change Notifications

Get instant notifications when service status changes. Configure webhooks to receive real-time updates about incidents, maintenance, and service recovery.

Webhook Events

  • • service.status_changed
  • • incident.created
  • • incident.resolved
  • • maintenance.scheduled
  • • maintenance.completed

Webhook Payload

{
  "event": "service.status_changed",
  "timestamp": "2024-03-12T17:08:00Z",
  "data": {
    "service": "API Gateway",
    "oldStatus": "operational",
    "newStatus": "degraded"
  }
}
Webhook Documentation

Try the API Now

Test our Status API directly from your browser. No authentication required for basic endpoints.