> ## 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 una base de datos por ID

> Obtiene los detalles de una base de datos concreta a partir de su ID.

**id** `string` *required*

El ID de la base de datos que se va a obtener. Si la base de datos pertenece a un workspace, pasa su ID en el parámetro de consulta `workspace_id`.

**workspace\_id** `string`

Si la base de datos pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúan sobre una base de datos que no les pertenece.

### Respuesta

**response** `object`

Los detalles de la base de datos.

**Mostrar objeto**

**id** `string`

El ID de la base de datos.

**cluster** `number`

El ID del clúster de la base de datos.

**type** `number`

El tipo de la base de datos.

**name** `string`

El nombre de la base de datos.

**description** `string`

La descripción de la base de datos.

**owner\_id** `string`

El ID del propietario de la base de datos.

**owner\_plan** `string | null`

El nombre del plan del propietario (por ejemplo, `pro` o `enterprise-8`), o `null` cuando el propietario no tiene plan.

**status** `string`

El estado de la base de datos (por ejemplo, `up`).

**ram** `number`

La RAM asignada a la base de datos, en MB.

**host** `string`

La dirección del host de la base de datos.

**port** `number`

El puerto que usa la base de datos.

**username** `string`

El usuario con el que conectarse. Las bases de datos creadas desde la v26.4.8 usan `vertracloud` (base de datos por defecto `vertracloud`, sin ser superusuario); las bases de datos anteriores conservan el usuario del motor (`postgres`, `default` o `root`).

**version** `string`

La versión mayor del motor, por ejemplo `"18"` u `"8.0"`. Las actualizaciones de seguridad se aplican al reiniciar sin cambiarla.

**stack\_id** `string | null`

El ID del [stack](https://docs.vertracloud.app/es-es/api-reference/endpoint/stacks/get.md) al que pertenece la base de datos, o `null` si no forma parte de ninguno.

**stack\_service\_key** `string | null`

El ID del servicio de plantilla que corresponde a esta base de datos dentro del stack, o `null` si la añadiste tú.

**created\_at** `string`

La marca de tiempo en que se creó la base de datos.

**updated\_at** `string`

La marca de tiempo de la última actualización de la base de datos.

**offline\_since** `string | null`

La marca de tiempo desde la que la base de datos está fuera de línea, si procede.

**last\_snapshot** `string | null`

La marca de tiempo del último snapshot, si está disponible.

```json Response theme={null}
{
  "response": {
    "id": "00000000000000000000000000000001",
    "cluster": 1,
    "type": 3,
    "name": "MyDatabase",
    "description": "I have a description :)",
    "owner_id": "123456789012345678",
    "owner_plan": "pro",
    "status": "up",
    "ram": 256,
    "host": "database.example.com",
    "port": 6379,
    "username": "vertracloud",
    "version": "8.2",
    "offline_since": null,
    "last_snapshot": "2026-03-14T19:58:00Z",
    "created_at": "2026-03-14T19:58:00Z",
    "updated_at": "2026-03-14T19:58:00Z"
  }
}
```

### 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 que no está en su lista de permitidas, o no tiene el ámbito que requiere la ruta (`403`).
* `ACCESS_DENIED`: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (`403`).
* `DATABASE_NOT_FOUND`: La base de datos indicada no existe o el usuario no tiene acceso.

**message** `string`

Un mensaje descriptivo con más detalles sobre el error.

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

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


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