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

# Información del usuario

> Devuelve la información completa del usuario, incluidas aplicaciones, bases de datos, plan y conexiones OAuth.

### Respuesta

**response** `APIUserInfoResponse`

Datos completos del usuario autenticado.

**Mostrar objeto**

**id** `string`

ID único del usuario (Snowflake).

**email** `string`

Correo electrónico del usuario.

**name** `string`

Nombre visible del usuario.

**language** `string`

Idioma preferido del usuario (`pt-br`, `en-us`, `es-es`).

**created\_at** `string`

Fecha de creación de la cuenta (ISO 8601).

**updated\_at** `string`

Fecha de la última actualización de la cuenta (ISO 8601).

**plan** `APIUserPlan | null`

Información del plan actual, o `null` cuando la cuenta no tiene un plan activo. Una cuenta sin plan no puede
crear aplicaciones ni bases de datos (`PLAN_REQUIRED`).

**Mostrar objeto**

**name** `string`

El nombre del plan: `economy`, `pro`, `scale`, `intermediary` o `enterprise-<GB>`, donde `<GB>` es 4, 6, 8, 12, 14, 16,
18, 20, 22, 24, 26, 28, 30 o 32 (por ejemplo, `enterprise-8`). El nombre es el único identificador del plan.

**expires\_at** `string`

Fecha de vencimiento del plan.

**duration** `integer`

Duración del plan en días.

**memory** `APIUserPlanMemory`

Uso de memoria del plan.

**Mostrar objeto**

**limit** `integer`

Límite de memoria en MB.

**used** `integer`

Memoria que se está usando actualmente, en MB.

**applications** `APIApplication[]`

Lista de aplicaciones del usuario.

**Mostrar objeto**

**id** `string`

ID único de la aplicación (Snowflake).

**cluster** `integer`

ID del clúster que aloja la aplicación.

**type** `integer`

Tipo de aplicación. `1` = Bot, `2` = Sitio web.

**name** `string`

Nombre de la aplicación.

**description** `string | undefined`

Descripción de la aplicación.

**language** `string`

Lenguaje de programación (`javascript`, `typescript`, `python`, `go`, `php`, `ruby`, `java`, `rust`, `bun`, `deno`, `dotnet`, `elixir`, `static`).

**ram** `integer`

Memoria asignada en MB.

**status** `string`

Estado actual: `up`, `down` o `building`.

**subdomain** `string | null`

Subdominio de la aplicación.

**domains** `APIApplicationDomain[]`

Los dominios personalizados de la aplicación, con estado, puerto, prefijo de ruta y redirección. Vacío cuando no tiene
ninguno. Los campos se describen en [Listar dominios de la aplicación](https://docs.vertracloud.app/es-es/api-reference/endpoint/apps/domains/list.md#respuesta).

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

El nombre del plan del propietario, o `null` cuando el propietario no tiene plan.

**main\_file** `string`

Archivo principal de la aplicación.

**version** `string`

Versión del runtime (`recommended`, `latest` o una versión específica).

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

Fecha del último snapshot.

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

Fecha desde la que la aplicación está fuera de línea. `null` si está en línea.

**created\_at** `string`

Fecha de creación.

**updated\_at** `string`

Fecha de la última actualización.

**databases** `APIDatabase[]`

Lista de bases de datos del usuario.

**Mostrar objeto**

**id** `string`

ID único de la base de datos (Snowflake).

**cluster** `integer`

ID del clúster.

**type** `integer`

Tipo: `1` = PostgreSQL, `2` = MongoDB, `3` = Redis, `4` = MySQL.

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

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

**name** `string`

Nombre de la base de datos.

**description** `string`

Descripción de la base de datos.

**status** `string`

Estado actual: `up`, `down` o `building`.

**ram** `integer`

Memoria asignada en MB.

**host** `string`

Dirección del host para la conexión.

**port** `integer`

Puerto de conexión.

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

Fecha del último snapshot.

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

Fecha desde la que está fuera de línea.

**created\_at** `string`

Fecha de creación.

**updated\_at** `string`

Fecha de la última actualización.

**resource\_organization** `APIWorkspaceResourceOrganization`

La organización personal del usuario. Es privada para este usuario e incluye las carpetas y los favoritos usados
para organizar aplicaciones y bases de datos. Los detalles de las modificaciones están en
[Organización personal de recursos](https://docs.vertracloud.app/es-es/api-reference/endpoint/users/resource-organization.md).

**Mostrar objeto**

**scope** `string`

Siempre `personal` en esta respuesta.

**user\_id** `string`

ID del usuario propietario de esta organización.

**workspace\_id** `string | null`

Siempre `null` en esta respuesta personal.

**folders** `APIWorkspaceResourceFolder[]`

Carpetas personales. Cada carpeta contiene `id`, `name`, `color`, `position`, `resources`,
`created_at` y `updated_at`. `color` es `neutral`, `red`, `orange`, `yellow`, `green`,
`blue` o `purple`.

**favorites** `APIWorkspaceFavorite[]`

Favoritos personales. Cada elemento contiene `resource_type` (`application` o `database`),
`resource_id`, `position` y `created_at`.

**connections** `APIUserConnection[]`

Cuentas OAuth vinculadas.

**Mostrar objeto**

**provider** `string`

Proveedor OAuth (`discord`, `github`, `google`).

**username** `string`

Nombre de usuario en el proveedor.

**created\_at** `string`

Fecha de vinculación.

```json Response theme={null}
{
  "response": {
    "id": "123456789012345678",
    "email": "user@example.com",
    "name": "user",
    "language": "pt-br",
    "plan": {
      "name": "pro",
      "expires_at": "2026-04-20T00:00:00.000Z",
      "duration": 30,
      "memory": {
        "limit": 1024,
        "used": 1024
      }
    },
    "applications": [
      {
        "id": "v111d4af8cd74272a284831fbae14a8v",
        "type": 2,
        "name": "My API",
        "description": "REST API with Express",
        "language": "javascript",
        "ram": 512,
        "status": "up",
        "subdomain": "my-api",
        "domains": [],
        "owner_plan": "pro",
        "owner_id": "123456789012345678",
        "main_file": "src/index.js",
        "version": "recommended",
        "start_command": "npm start",
        "last_snapshot": "2026-03-15T10:00:00.000Z",
        "offline_since": null,
        "created_at": "2026-01-15T15:51:47.234Z",
        "updated_at": "2026-03-19T15:06:41.449Z"
      }
    ],
    "databases": [
      {
        "id": "v41806687fe6488884a464d1dc06692v",
        "type": 1,
        "owner_plan": "pro",
        "name": "my-postgres",
        "description": "PostgreSQL Database",
        "status": "up",
        "ram": 1024,
        "host": "database.example.com",
        "port": 5432,
        "owner_id": "123456789012345678",
        "last_snapshot": "2026-03-18T00:00:00.000Z",
        "offline_since": null,
        "created_at": "2026-02-01T22:00:54.785Z",
        "updated_at": "2026-03-19T22:13:38.489Z"
      }
    ],
    "connections": [
      {
        "provider": "github",
        "username": "myuser",
        "created_at": "2026-01-15T15:51:47.234Z"
      },
      {
        "provider": "discord",
        "username": "myuser#1234",
        "created_at": "2026-01-15T15:51:47.234Z"
      }
    ],
    "created_at": "2026-01-15T01:26:04.784Z",
    "updated_at": "2026-03-19T22:10:31.220Z"
  }
}
```


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