# ES·pera Public Data API

**Canonical:** https://apis.io/apis/es-pera/espera-public-data-api/  
**Provider:** ES·pera API — https://apis.io/providers/es-pera/  
**Base URL:** https://es-pera.org/api/v1  
**Documentation:** https://es-pera.org/metodologia/api/

ES·pera Public Data API is published by [ES·pera API](https://apis.io/providers/es-pera/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Healthcare, Open Data, Waiting Lists, hospital activity, and Spain. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Open, unauthenticated read-only REST API (GET/HEAD, JSON) over SNS hospital and autonomous-community waiting-list open data. Nine operations across health/releases, hospital entities and metrics, and paginated autonomous waiting-list observations. Responses are served from immutable, content-addressed data releases; anonymous traffic is rate limited (120/min overall, 20/min for facets and observations).

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Comprueba el estado de la API y sus releases |
| GET | `/releases/current` | Devuelve las releases activas del despliegue |
| GET | `/metrics` | Enumera las métricas hospitalarias publicadas |
| GET | `/entities` | Busca hospitales o enumera complejos |
| GET | `/entities/{entityId}` | Devuelve el detalle publicado de una entidad |
| GET | `/waiting/releases/current` | Devuelve la release autonómica activa |
| GET | `/waiting/communities` | Enumera la cobertura autonómica disponible |
| GET | `/waiting/facets` | Enumera filtros disponibles para una comunidad |
| GET | `/waiting/observations` | Consulta observaciones autonómicas paginadas |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/es-pera/refs/heads/main/openapi/es-pera-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/es-pera/refs/heads/main/overlays/es-pera-openapi-overlay.yaml
- **Documentation** — https://es-pera.org/metodologia/api/
- **APIReference** — https://es-pera.org/metodologia/api/
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/es-pera/refs/heads/main/apis.yml

## Tags

Healthcare, Open Data, Waiting Lists, hospital activity, Spain, Public Sector, Government Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/es-pera/espera-public-data-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/es-pera/.
