Skip to main content

Cloudflare Status API

Programmatic access to Cloudflare service status, incidents, and scheduled maintenance.

Basics

Most endpoints return JSON and require no authentication. The URLs below reflect the host you're currently viewing, so the same examples work in any environment.

Automated access

Use the API for automated polling; do not scrape the HTML status pages. Automated HTML requests may be rate limited or blocked. Agentic clients may request the Markdown representation with Accept: text/markdown.

Send an identifiable User-Agent with a contact URL or email, for example ExampleMonitor/1.0 (+https://example.com/contact). Requests without a User-Agent are subject to more aggressive rate limiting.

Page Status

GET

Summary

Get a snapshot of the entire status page, including the overall indicator, component statuses, unresolved incidents, and any upcoming or in-progress scheduled maintenance events. Most consumers only need this endpoint.

https://www.cloudflarestatus.com/api/v2/summary.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/summary.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Status

Get the overall status for the whole page. Returns a single indicator, one of none, minor, major, or critical, plus a human-readable description like "All Systems Operational" or "Partial System Outage".

https://www.cloudflarestatus.com/api/v2/status.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/status.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Components

Get the components for the page. Each component is listed along with its status: operational, degraded_performance, partial_outage, or major_outage.

https://www.cloudflarestatus.com/api/v2/components.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/components.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'

Incidents

GET

Unresolved incidents

Get a list of any unresolved incidents. Returns only incidents in the investigating, identified, or monitoring state.

https://www.cloudflarestatus.com/api/v2/incidents/unresolved.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/incidents/unresolved.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

All incidents

Get the 50 most recent incidents. Includes all unresolved incidents as described above, plus those in the resolved and postmortem state.

https://www.cloudflarestatus.com/api/v2/incidents.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/incidents.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'

Scheduled maintenances

GET

Upcoming

Get a list of any upcoming maintenance events. Returns only maintenance events still in the scheduled state.

https://www.cloudflarestatus.com/api/v2/scheduled-maintenances/upcoming.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/scheduled-maintenances/upcoming.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Active

Get a list of any active maintenance events. Returns only maintenance events in the in_progress or verifying state.

https://www.cloudflarestatus.com/api/v2/scheduled-maintenances/active.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/scheduled-maintenances/active.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

All maintenances

Get the 50 most recent scheduled maintenance events. Includes upcoming and active maintenance events as described above, plus those in the completed state.

https://www.cloudflarestatus.com/api/v2/scheduled-maintenances.json

REQUEST

curl https://www.cloudflarestatus.com/api/v2/scheduled-maintenances.json -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'

Feeds

GET

Incidents RSS

RSS 2.0 feed of the 50 most recent incidents. Each item links back to the public incident page.

https://www.cloudflarestatus.com/api/v3/incidents.rss

REQUEST

curl https://www.cloudflarestatus.com/api/v3/incidents.rss -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Incidents Atom

Atom 1.0 feed of the 50 most recent incidents. Each entry links back to the public incident page.

https://www.cloudflarestatus.com/api/v3/incidents.atom

REQUEST

curl https://www.cloudflarestatus.com/api/v3/incidents.atom -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Maintenance RSS

RSS 2.0 feed of the 50 most recent scheduled maintenance events. Each item includes the maintenance window's end date.

https://www.cloudflarestatus.com/api/v3/maintenance.rss

REQUEST

curl https://www.cloudflarestatus.com/api/v3/maintenance.rss -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'
GET

Maintenance Atom

Atom 1.0 feed of the 50 most recent scheduled maintenance events. Each entry links back to the public maintenance page.

https://www.cloudflarestatus.com/api/v3/maintenance.atom

REQUEST

curl https://www.cloudflarestatus.com/api/v3/maintenance.atom -H 'User-Agent: ExampleMonitor/1.0 (+https://example.com/contact)'