*MCP › Referencia › Catálogo e inventario › Disponibilidad*

# Listar las indisponibilidades de un recurso

> Devuelve las ventanas en las que una persona, un vehículo o un espacio NO está disponible.

`absenceType` se emite para vehículos y espacios, donde es operativo, y NO para personas, donde sería un dato de salud. El motivo de la indisponibilidad no se emite nunca. Solo se devuelven las declaraciones con `state: unavailable` que aún no han terminado (actuales o futuras): una indisponibilidad desaparece de la lista cuando pasa su fecha de fin, y las ventanas `available` o `unknown` nunca se listan.

HERRAMIENTA `filmo_unavailabilities_list` · `availability:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `resourceType` | string | Sí | Qué recursos consultar. `staff`, `vehicle`, `space` |
| `resourceId` | string | No | Limita a un recurso concreto. |
| `startDate` | string<date-time> | No | Inicio de la ventana, en ISO 8601 con desplazamiento. |
| `endDate` | string<date-time> | No | Fin de la ventana, en ISO 8601 con desplazamiento. |
| `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` |
| `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único de la indisponibilidad. |
| `resourceType` | string | Qué recurso: staff, vehicle o space. |
| `resourceId` | string | Identificador de ese recurso. |
| `resourceName` | string | Nombre del recurso; null si no consta. |
| `startDate` | string<date-time> | Inicio de la indisponibilidad en ISO 8601 UTC. |
| `endDate` | string<date-time> | Fin de la indisponibilidad en ISO 8601 UTC. |
| `state` | string | Estado declarado. Este listado solo devuelve ventanas `unavailable` que aún no han terminado, así que aquí siempre es `unavailable`; `available` y `unknown` existen como declaraciones pero no se listan. |
| `absenceType` | string | Tipo de ausencia. Solo se emite para vehículos y espacios, donde es operativo; para el personal es un dato de salud y se devuelve como null. |
| `updatedAt` | string<date-time> | Última modificación en ISO 8601 UTC; null si no está registrada. |

*Llamada · filmo_unavailabilities_list*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_unavailabilities_list",
    "arguments": {
      "resourceType": "staff",
      "limit": 20
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "resourceType": "<resourceType>",
        "resourceId": "reso_8f2a1c",
        "resourceName": "Example",
        "startDate": "2026-09-01T08:00:00Z",
        "endDate": "2026-09-01T08:00:00Z",
        "state": "<state>",
        "absenceType": "<absenceType>",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`GET /api/v1/availability/unavailabilities`](https://docs.filmo.io/es/rest-api/endpoint-reference/availability/list-the-unavailabilities-of-a-resource).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/availability/filmo-unavailabilities-list  
Última actualización: 2026-10-25