*API REST › Referencia de endpoints › Operaciones › Vehículos* # Comprobar la disponibilidad de la flota > Devuelve, para cada vehículo (toda la flota, o los seleccionados por `vehicleIds`, `tags`, `collectionId` o `search`), si tiene compromisos que se solapan con la ventana consultada y cuáles, tipificados. Misma forma de respuesta que la disponibilidad del personal. Un identificador solicitado que no existe vuelve como `error` por elemento. Consulta idempotente (POST por el cuerpo estructurado). Comparte la cuota de disponibilidad de 30 req/min. `POST /api/v1/vehicles/availability` — permiso `vehicles:read` Permiso: `vehicles:read` · 120/min · +30/min de disponibilidad · Ámbito estricto · MCP: `filmo_vehicles_availability_check` ## Autorizaciones Clave de API como Bearer, con el permiso de abajo. `vehicles:read` ## Cuerpo Esquema del cuerpo: `VehicleAvailabilityBody` | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `startDate` | string | Sí | Inicio de la ventana a comprobar (ISO 8601 con desplazamiento). | | `endDate` | string | Sí | Fin de la ventana que se comprueba (ISO 8601 con desplazamiento); debe ser posterior a startDate. | | `tags` | string[] | No | Solo los recursos que tengan TODOS estos identificadores de etiqueta. | | `collectionId` | string | No | Solo los recursos de esta colección. | | `search` | string | No | Búsqueda de texto libre en el nombre. | | `vehicleIds` | string[] | No | Limita la respuesta a estos vehículos (1-100). Un identificador que no existe vuelve como error por elemento. | ## Ejemplos de petición *Comprobar la disponibilidad de la flota* **cURL** ```bash curl https://app.filmo.io/api/v1/vehicles/availability \ --request POST \ --header "Authorization: Bearer $FILMO_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "startDate": "2026-09-01T08:00:00Z", "endDate": "2026-09-03T20:00:00Z", "tags": [ "tag_furgonetas" ] }' ``` **Node.js** ```javascript fetch('https://app.filmo.io/api/v1/vehicles/availability', { method: 'POST', headers: { Authorization: 'Bearer YOUR_FILMO_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ startDate: '2026-09-01T08:00:00Z', endDate: '2026-09-03T20:00:00Z', tags: ['tag_furgonetas'] }) }) ``` **Python** ```python import requests requests.post( "https://app.filmo.io/api/v1/vehicles/availability", headers={ "Authorization": "Bearer YOUR_FILMO_API_KEY", "Content-Type": "application/json" }, json={ "startDate": "2026-09-01T08:00:00Z", "endDate": "2026-09-03T20:00:00Z", "tags": [ "tag_furgonetas" ] } ) ``` ## Respuesta Esquema de la respuesta: `ResourceAvailabilityEntryDto` | Estado | Descripción | | --- | --- | | 200 | Respuesta correcta. | | 400 | Petición no válida (validation_error): consulta o cuerpo mal formados. `errors[]` enumera cada campo erróneo con su código estable. | | 401 | Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin). | | 403 | No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en `requiredScope`; forbidden: el propietario de la clave carece del permiso que exige la operación). `insufficient_scope` se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras `RateLimit-*`; `forbidden` sí. | | 404 | Recurso no encontrado (not_found): no existe o está fuera del alcance de la clave de API. | | 409 | Conflicto (conflict): el estado actual del recurso impide la operación, ya hay en curso una petición con esa Idempotency-Key, o otra escritura condicional (`If-Match`) retuvo el recurso durante más de cinco segundos. `errors[0].code` indica cuál: `in_progress` y `lock_timeout` se resuelven reintentando; `invalid_state` no, porque el estado del recurso prohíbe la operación. | | 429 | Límite de peticiones superado (rate_limited): reintenta tras `Retry-After` segundos; `RateLimit-*` indica qué cuota se ha agotado. | | 500 | Error interno (internal_error). | **200** | Nombre | Tipo | Descripción | | --- | --- | --- | | `data` | object[] | | | `meta` | object | Información adicional sobre la respuesta. | | `meta.warnings` | object[] | Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta. | | `meta.warnings.code` | string | Código de aviso estable. `deprecated` | | `meta.warnings.message` | string | Para personas: qué está obsoleto, hasta cuándo y qué usar. | | `meta.warnings.sunset` | string | Día (YYYY-MM-DD) en que la operación deja de estar disponible. | | `meta.warnings.replacement` | string | `operationId` de la operación que hay que usar en su lugar, o null si no hay ninguna. | | `meta.warnings.link` | string | Dónde está documentada la deprecación (el changelog). | *Respuesta de ejemplo · 200* ```json { "data": [ { "resourceId": "resource_9f3a2b", "name": "Example resource availability entry", "available": true, "commitments": [ { "kind": "order", "orderId": "order_9f3a2b", "orderNumber": "2026-0001", "label": "Main", "startDate": "2026-09-01T08:00:00.000Z", "endDate": "2026-09-01T08:00:00.000Z" } ] } ] } ``` ## Errores | Estado | Códigos | Significado | | --- | --- | --- | | 400 | `validation_error` | Consulta o cuerpo mal formados. `errors[]` enumera cada campo erróneo con su código estable. | | 404 | `not_found` | No existe o queda fuera del alcance de la clave de API. | | 409 | `conflict` | El estado actual del recurso impide la operación, ya hay en curso una petición con esa Idempotency-Key, u otra escritura condicional (`If-Match`) retuvo el recurso durante más de cinco segundos. `errors[0].code` indica cuál: `in_progress` y `lock_timeout` se resuelven reintentando; `invalid_state` no, porque el estado del recurso prohíbe la operación. | ## Obsolescencia Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. --- URL canónica: https://docs.filmo.io/es/rest-api/endpoint-reference/vehicles/check-fleet-availability Última actualización: 2026-10-25