---
title: "Predicción para las playas. Tiempo actual."
method: GET
path: "/api/prediccion/especifica/playa/{playa}"
tags: ["predicciones-especificas"]
---

# Predicción para las playas. Tiempo actual.

`GET /api/prediccion/especifica/playa/{playa}`

## Request

- Base URL: `https://opendata.aemet.es/opendata`
- URL: `https://opendata.aemet.es/opendata/api/prediccion/especifica/playa/{playa}`
- Auth: API key in header `api_key`
- TypeScript: <https://skmtc.dev/aemet/apis/aemet-opendata/docs/api/prediccion/especifica/playa/:playa/get.ts> (a function with typed inputs; its response is checked against the schema)

La predicción diaria de la playa que se pasa como parámetro. Establece el estado de nubosidad para unas horas determinadas, las 11 y las 17 hora oficial. Se analiza también si se espera precipitación en el entorno de esas horas, entre las 08 y las 14 horas y entre las 14 y 20 horas.<br><br> [Canales RSS](https://opendata.aemet.es/centrodedescargas/rssatom) disponibles:
        <ul>
        <li>Predicción playa</li>
        </ul>

## Path parameters

- `playa` string, required

## Response `200`

respuesta con éxito

- 200
  - `descripcion` string, required
  - `estado` integer, required
  - `datos` string, required
  - `metadatos` string, required

## Other responses

- `400`: petición incorrecta
- `401`: petición no autorizada
- `403`: acceso denegado
- `404`: petición sin datos
- `429`: petición que sobrepasa los límites del servicio

## Changes

- **2026-09-02** `2e5deaf5f149`: 2 info
  - added the non-success response with the status `400`
  - the `descripcion` response's property default value changed from `Unauthorized` to `Forbidden` for the status `403`
- **2026-08-06** `11e81d8ddea0`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/aemet/apis/aemet-opendata/changes/api/prediccion/especifica/playa/:playa/get.md)

---

[API](https://skmtc.dev/aemet/apis/aemet-opendata.md) - [All operations](https://skmtc.dev/aemet/apis/aemet-opendata/llms.txt) - [OpenAPI document](https://skmtc.dev/aemet/apis/aemet-opendata/revisions/2e5deaf5f149?raw)