📚 Documentation & Examples
Everything you need to integrate with DigitalOcean Status
🚀 Quick Start Examples
// DigitalOcean Status API Example
const response = await fetch('https://status.digitalocean.com/api', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);The DigitalOcean Status API provides real-time insights into the operational status of all DigitalOcean services, allowing developers and businesses to monitor and ensure the reliability of their applications hosted on the platform. By integrating this API into your applications or workflows, you can keep your users informed of any ongoing incidents, maintenance windows, or performance issues that may affect their experience. With easy access to service statuses, organizations can enhance their responsiveness to outages or service degradations, ensuring that both technical teams and end-users are aware of the current service health.
Utilizing the DigitalOcean Status API comes with several benefits, including real-time updates on service availability, the ability to automate incident notifications, and the freedom to customize alert systems based on service status changes. Additionally, the API enables businesses to analyze status patterns over time, assisting in proactive management of service-level agreements (SLAs). Here are some key benefits of using the DigitalOcean Status API:
- Real-time monitoring of DigitalOcean services
- Automatic notifications for service incidents and maintenance
- Customizable alerts for service status changes
- Historical data analysis for service reliability
- Enhanced user communication during outages
Here’s a simple JavaScript example to call the DigitalOcean Status API using Fetch API:
fetch('https://status.digitalocean.com/api/v2/status.json')
.then(response => response.json())
.then(data => {
console.log('Current Status:', data.status.description);
})
.catch(error => {
console.error('Error fetching status:', error);
});
Getting Started — No API Key Required
The DigitalOcean Status API is public and needs no key or authentication — it's a standard Atlassian Statuspage feed, so you can request any of its JSON endpoints directly:
curl "https://status.digitalocean.com/api/v2/summary.json"
Handy endpoints (all under https://status.digitalocean.com/api/v2/):
status.json— overall status indicator and description.summary.json— status plus all components and any active incidents.components.json— per-service status (Droplets, Spaces, networking, etc.).incidents/unresolved.json— only currently open incidents.scheduled-maintenances/upcoming.json— planned maintenance windows.
curl -s "https://status.digitalocean.com/api/v2/status.json"
# {"status":{"indicator":"none","description":"All Systems Operational"}, ...}
Because there's no key, there's no per-account rate limit to manage, but poll politely (for example once a minute) and cache rather than hammering the endpoint. The full Statuspage schema is linked at https://status.digitalocean.com/api.
