> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar jobs de snapshot

> Lista los jobs de snapshot y de restauración de una aplicación o base de datos, del más reciente al más antiguo. Requiere el scope snapshots:read.

Un snapshot o una restauración puede tardar más que una petición. Cada uno es un **job** que puedes seguir: un snapshot manual que
no termina en 90 segundos responde `202` con un `job_id`, y una [restauración](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/restore.md)
responde siempre `202` con uno. Esta ruta lista los jobs de un recurso; [Obtener job de snapshot](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/jobs/get.md) lee uno solo.

**id** `string` *required*

El ID de la aplicación o de la base de datos.

**scope** `string` *required*

El tipo de recurso. Valores posibles: `applications`, `databases`.

**workspace\_id** `string`

Si el recurso pertenece a un workspace, el ID del workspace.

**kind** `string`

Solo jobs de este tipo: `snapshot` o `restore`. Por defecto: ambos.

**limit** `number`

Número máximo de jobs, de `1` a `50`. Por defecto `10`. Un valor fuera de ese rango responde `400 VALIDATION_ERROR`.

### Respuesta

**response** `array`

Los jobs, del más reciente al más antiguo.

**Mostrar objeto**

**id** `string`

El ID del job.

**kind** `string`

`snapshot` o `restore`.

**resource\_id** `string`

El recurso sobre el que actúa el job: el que recibe la copia o el destino de una restauración.

**origin** `string`

Solo en los jobs de snapshot: qué pidió el snapshot, el mismo `origin` que recibe: `manual` (tú) o `automatic` (el backup diario del plan, o el snapshot que la plataforma hace antes de quitar un recurso, por ejemplo cuando vence el plan). Ausente en los jobs de restauración.

**status** `string`

`queued` (esperando para empezar), `running`, `ready` (terminado), `skipped` (no se hizo nada porque el recurso dejó de existir o, en una base de datos, está detenida) o `failed`. `ready`, `skipped` y `failed` son finales: el job ya no cambia.

**reason** `string`

Presente cuando el job está `failed` o `skipped`: el código de error que dice el motivo, como `SNAPSHOT_TIMEOUT` o `SNAPSHOT_CORRUPTED`. Consulta los [códigos de error](https://docs.vertracloud.app/es-es/api-reference/errors.md).

**snapshot\_id** `string`

En un job `snapshot`, el snapshot que produjo: siempre presente cuando el job está `ready`, así que puedes leer el snapshot justo después. En un job `restore`, el snapshot que se está restaurando, presente desde el principio.

**details** `object`

Presente junto con `reason` cuando el error trae detalles: los mismos `details` que el error tendría en una respuesta directa. `max_bytes` para `SNAPSHOT_TOO_LARGE`; `required_bytes`, `available_bytes` y, en una base de datos, `required_ram_mb` para `SNAPSHOT_EXCEEDS_STORAGE`.

**created\_at** `string`

Cuándo se creó el job.

**started\_at** `string`

Cuándo empezó el job. Ausente mientras `queued`.

**finished\_at** `string`

Cuándo terminó el job. Ausente hasta entonces.

**progress** `object`

Solo mientras el job está `running`, y puede faltar (por ejemplo justo al empezar, o cuando no se conoce el progreso). No se envía en ningún otro estado.

**Mostrar objeto**

**phase** `string`

`preparing`, `copying` o `finishing`.

**percent** `number`

Progreso general, de 0 a 100. Ausente cuando no se conoce el tamaño total.

**done\_bytes** `number`

Bytes procesados hasta ahora.

**total\_bytes** `number`

Total de bytes a procesar.

**eta\_seconds** `number`

Estimación de segundos restantes. Ausente hasta que la estimación es estable.

```json Response theme={null}
{
  "response": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "kind": "restore",
      "resource_id": "550e8400-e29b-41d4-a716-446655440001",
      "status": "running",
      "created_at": "2026-11-17T15:00:00.000Z",
      "started_at": "2026-11-17T15:00:04.000Z",
      "progress": {
        "phase": "copying",
        "percent": 42,
        "done_bytes": 314572800,
        "total_bytes": 734003200,
        "eta_seconds": 18
      }
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "kind": "snapshot",
      "resource_id": "550e8400-e29b-41d4-a716-446655440001",
      "origin": "automatic",
      "status": "ready",
      "snapshot_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2026-11-17T14:59:40.000Z",
      "started_at": "2026-11-17T14:59:41.000Z",
      "finished_at": "2026-11-17T14:59:58.000Z"
    }
  ]
}
```

Los jobs de un recurso que se borró se siguen devolviendo a la cuenta que lo poseía. Para un recurso que no existe, la lista vuelve vacía. Esta ruta admite 120 peticiones por minuto.

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope `snapshots:read` (`403`).
* `ACCESS_DENIED`: Eres miembro de un workspace sin el permiso para esta acción, o no enviaste el `workspace_id` (`403`).
* `VALIDATION_ERROR`: `limit` no es un número de 1 a 50, o `scope` o `kind` tienen un valor que no existe (`400`).
* `INTERNAL_SERVER_ERROR`: Ocurrió un error inesperado del servidor.

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.