> ## 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.

# Obtener job de snapshot

> Lee un job de snapshot o restauración de una aplicación o base de datos. Consúltalo hasta que termine. Requiere el scope snapshots:read.

Usa esta ruta para seguir una [restauración](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/restore.md) (`response.job_id`) o un snapshot manual
que respondió `202` (`response.job_id`). Consúltala cada pocos segundos hasta que el `status` sea `ready`, `skipped` o `failed`.
La forma del job es la descrita en [Listar jobs de snapshot](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/snapshots/jobs/list.md).

**id** `string` *required*

El ID de la aplicación o de la base de datos a la que pertenece el job. En una restauración, es el recurso que se está restaurando.

**job\_id** `string` *required*

El ID del job.

**scope** `string`

Opcional. El tipo de recurso: `applications` o `databases`.

**workspace\_id** `string`

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

### Respuesta

**response** `object`

El job: `id`, `kind`, `resource_id`, `origin` (solo en los jobs de snapshot), `status`, `reason` (cuando está `failed` o `skipped`), `details` (los detalles de ese error, cuando los hay), `snapshot_id` (el snapshot que produjo un job `snapshot`, siempre presente cuando está `ready`; en un job `restore`, el snapshot que se está restaurando), `created_at`, `started_at`, `finished_at` y, mientras está `running`, `progress`.

**response.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": "failed",
    "reason": "SNAPSHOT_EXCEEDS_STORAGE",
    "details": {
      "required_bytes": 734003200,
      "available_bytes": 524288000
    },
    "snapshot_id": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2026-11-17T15:00:00.000Z",
    "started_at": "2026-11-17T15:00:04.000Z",
    "finished_at": "2026-11-17T15:00:06.000Z"
  }
}
```

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`).
* `SNAPSHOT_NOT_FOUND`: No se encontró (`404`).
* `INTERNAL_SERVER_ERROR`: Ocurrió un error inesperado del servidor.

```json Error Response (404) theme={null}
{
  "code": "SNAPSHOT_NOT_FOUND"
}
```


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