# Status Pages API reference

Use this as compact context for the live bluedoor Status Pages API.

Primary URLs:

- API base URL: https://api.bluedoor.sh/status-pages/v1
- OpenAPI JSON: https://bluedoor.sh/apis/status-pages/docs/openapi.json
- Upstream OpenAPI JSON: https://api.bluedoor.sh/status-pages/v1/openapi.json
- Docs: https://bluedoor.sh/apis/status-pages/docs
- Landing page: https://bluedoor.sh/apis/status-pages
- Data pages: https://bluedoor.sh/data/status-pages

Authentication and rate limits:

- Anonymous reads are public and rate limited.
- Email-authenticated API keys are minted through POST /v1/auth/otp and POST /v1/auth/verify.
- Use Authorization: Bearer <key>, x-api-key, or api_key query.
- Responses expose x-rate-limit-limit, x-rate-limit-remaining, x-rate-limit-reset, and x-rate-limit-tier.
- fresh=true, refresh=true, and live=true require a verified email API key.
- Webhooks require a verified API key.

Important routes:

- GET /health
- GET /v1/meta
- GET /v1/scorecard
- GET /v1/coverage/providers
- GET /v1/coverage/providers/{provider_id}
- GET /v1/companies
- GET /v1/companies/{id}
- GET /v1/status-pages
- GET /v1/status-pages/{id}
- GET /v1/services
- GET /v1/services/{id}
- GET /v1/incidents
- GET /v1/incidents/{id}
- GET /v1/sources
- GET /v1/sources/{id}
- GET /v1/search
- GET /v1/usage
- POST /v1/auth/otp
- POST /v1/auth/verify
- POST /v1/auth/limits/requests
- POST /v1/webhooks
- GET /v1/webhooks
- DELETE /v1/webhooks/{webhook_id}

Examples:

```bash
curl "https://api.bluedoor.sh/status-pages/v1/meta"
curl "https://api.bluedoor.sh/status-pages/v1/companies?q=openai&exclude_likely_spam=true"
curl "https://api.bluedoor.sh/status-pages/v1/coverage/providers/atlassian_statuspage"
curl "https://api.bluedoor.sh/status-pages/v1/search?q=github"
curl "https://api.bluedoor.sh/status-pages/v1/meta?fresh=true" -H "Authorization: Bearer $STATUS_PAGES_API_KEY"
```