API reference

Status and metadata

Service health, the enum vocabulary, and the attribution every source requires. Base URL https://emergencyapi.com/api/v1.

GET/status

API health check

Returns API health, version, uptime, and a summary of feed statuses.

Responses

StatusDescription
200API health status
Request
curl "https://emergencyapi.com/api/v1/status"
GET/attribution

Data source attributions

Returns attribution information for all data sources, including licence details. Required for CC BY compliance.

Responses

StatusDescription
200Attribution data for all sources
Request
curl "https://emergencyapi.com/api/v1/attribution"
GET/schema

API schema and valid enum values

Returns all valid enum values for event types, categories, states, warning levels, and other filterable fields. Use this to discover what values are accepted by filter parameters. No authentication required.

Responses

StatusDescription
200All valid enum values and category mappings
Request
curl "https://emergencyapi.com/api/v1/schema" \
  -H "Authorization: Bearer YOUR_API_KEY"