User Information

curl --request GET \
  --url https://api.vertracloud.app/v1/users/@me

{
  "response": {
    "id": "993591427428790342",
    "email": "[email protected]",
    "name": "user",
    "plan_id": 3,
    "language": "pt-br",
    "plan": {
      "id": 3,
      "name": "pro",
      "expires_at": "2026-04-20T00:00:00.000Z",
      "duration": 30,
      "memory": {
        "limit": 4096,
        "used": 1024
      }
    },
    "applications": [
      {
        "id": "v111d4af8cd74272a284831fbae14a8v",
        "cluster": 1,
        "type": 2,
        "name": "My API",
        "description": "REST API with Express",
        "language": "javascript",
        "ram": 512,
        "status": "up",
        "subdomain": "my-api",
        "custom_domain": null,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "main_file": "src/index.js",
        "version": "recommended",
        "auto_restart": true,
        "start_command": "npm start",
        "use_credits": false,
        "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",
        "cluster": 1,
        "type": 1,
        "name": "my-postgres",
        "description": "PostgreSQL Database",
        "status": "up",
        "ram": 1024,
        "host": "v41806687fe6488884a464d1dc06692v.db.usa1.vertraweb.app",
        "port": 14523,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "use_credits": true,
        "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"
      }
    ],
    "credits": {
      "compute": {
        "free": 450.5,
        "paid": 1200.0,
        "free_per_week": 2000,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      },
      "ai": {
        "free": 120.0,
        "paid": 500.0,
        "free_per_week": 500,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      }
    },
    "created_at": "2026-01-15T01:26:04.784Z",
    "updated_at": "2026-03-19T22:10:31.220Z"
  }
}

GET

users

@me

User Information

curl --request GET \
  --url https://api.vertracloud.app/v1/users/@me

{
  "response": {
    "id": "993591427428790342",
    "email": "[email protected]",
    "name": "user",
    "plan_id": 3,
    "language": "pt-br",
    "plan": {
      "id": 3,
      "name": "pro",
      "expires_at": "2026-04-20T00:00:00.000Z",
      "duration": 30,
      "memory": {
        "limit": 4096,
        "used": 1024
      }
    },
    "applications": [
      {
        "id": "v111d4af8cd74272a284831fbae14a8v",
        "cluster": 1,
        "type": 2,
        "name": "My API",
        "description": "REST API with Express",
        "language": "javascript",
        "ram": 512,
        "status": "up",
        "subdomain": "my-api",
        "custom_domain": null,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "main_file": "src/index.js",
        "version": "recommended",
        "auto_restart": true,
        "start_command": "npm start",
        "use_credits": false,
        "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",
        "cluster": 1,
        "type": 1,
        "name": "my-postgres",
        "description": "PostgreSQL Database",
        "status": "up",
        "ram": 1024,
        "host": "v41806687fe6488884a464d1dc06692v.db.usa1.vertraweb.app",
        "port": 14523,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "use_credits": true,
        "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"
      }
    ],
    "credits": {
      "compute": {
        "free": 450.5,
        "paid": 1200.0,
        "free_per_week": 2000,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      },
      "ai": {
        "free": 120.0,
        "paid": 500.0,
        "free_per_week": 500,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      }
    },
    "created_at": "2026-01-15T01:26:04.784Z",
    "updated_at": "2026-03-19T22:10:31.220Z"
  }
}

Response

response

APIUserInfoResponse

Complete authenticated user data.

Show Toggle object

string

Unique user ID (Snowflake).

string

User email.

name

string

User display name.

plan_id

integer

Numeric plan ID. Values: 1=FREE, 2=ECONOMY, 3=PRO, 4=SCALE, 9=INTERMEDIARY, 5=ENTERPRISE_4, 19=ENTERPRISE_6, 6=ENTERPRISE_8, 10=ENTERPRISE_12, 11=ENTERPRISE_14, 7=ENTERPRISE_16, 12=ENTERPRISE_18, 13=ENTERPRISE_20, 14=ENTERPRISE_22, 15=ENTERPRISE_24, 16=ENTERPRISE_26, 17=ENTERPRISE_28, 18=ENTERPRISE_30, 8=ENTERPRISE_32.

language

string

User’s preferred language (pt-br, en-us, es-es).

created_at

string

Account creation date (ISO 8601).

updated_at

string

Account last update date (ISO 8601).

plan

APIUserPlan

Current plan information.

Show Toggle object

integer

Plan ID.

name

string

Plan name (e.g., free, pro, scale).

expires_at

string | null

Plan expiration date. null for plans without expiration.

duration

integer

Plan duration in days.

memory

APIUserPlanMemory

Plan memory usage.

Show Toggle object

limit

integer

Memory limit in MB.

used

integer

Memory currently in use in MB.

applications

APIApplication[]

List of user applications.

Show Toggle object

string

Unique application ID (Snowflake).

cluster

integer

ID of the cluster hosting the application.

type

integer

Application type. 1 = Bot, 2 = Website.

name

string

Application name.

description

string | undefined

Application description.

language

string

Programming language (javascript, typescript, python, go, php, ruby, java, rust, bun, static).

ram

integer

Memory allocated in MB.

status

string

Current status: up or down.

subdomain

string | null

Application subdomain.

custom_domain

string | null

Custom domain, if configured.

main_file

string

Application main file.

version

string

Runtime version (recommended, latest, or specific version).

auto_restart

boolean

Whether auto-restart is enabled.

use_credits

boolean

Whether the application uses credits mode.

last_snapshot

string | null

Date of the last snapshot.

offline_since

string | null

Date since the application is offline. null if online.

created_at

string

Creation date.

updated_at

string

Last update date.

databases

APIDatabase[]

List of user databases.

Show Toggle object

string

Unique database ID (Snowflake).

cluster

integer

Cluster ID.

type

integer

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

name

string

Database name.

description

string

Database description.

status

string

Current status: up or down.

ram

integer

Memory allocated in MB.

host

string

Host address for connection.

port

integer

Connection port.

use_credits

boolean

Whether the database uses credits mode.

last_snapshot

string | null

Date of the last snapshot.

offline_since

string | null

Date since offline.

created_at

string

Creation date.

updated_at

string

Last update date.

connections

APIUserConnection[]

Linked OAuth accounts.

Show Toggle object

provider

string

OAuth provider (discord, github, google).

username

string

Username on the provider.

created_at

string

Binding date.

credits

APIUserCredits

User credits balance, split into compute and AI.

Show Toggle object

compute

APICreditCompute

Compute credits (for running apps and databases).

Show Toggle object

free

number

Free compute credits balance.

paid

number

Paid compute credits balance.

free_per_week

number

Weekly allocation of free credits.

free_reset_at

string

Date of next free credits reset.

paid_expires_at

string | null

Paid credits expiration date.

APICreditAI

AI credits (for AI features).

Show Toggle object

free

number

Free AI credits balance.

paid

number

Paid AI credits balance.

free_per_week

number

Weekly allocation of free AI credits.

free_reset_at

string

Date of next free AI credits reset.

paid_expires_at

string | null

Paid AI credits expiration date.

{
  "response": {
    "id": "993591427428790342",
    "email": "[email protected]",
    "name": "user",
    "plan_id": 3,
    "language": "pt-br",
    "plan": {
      "id": 3,
      "name": "pro",
      "expires_at": "2026-04-20T00:00:00.000Z",
      "duration": 30,
      "memory": {
        "limit": 4096,
        "used": 1024
      }
    },
    "applications": [
      {
        "id": "v111d4af8cd74272a284831fbae14a8v",
        "cluster": 1,
        "type": 2,
        "name": "My API",
        "description": "REST API with Express",
        "language": "javascript",
        "ram": 512,
        "status": "up",
        "subdomain": "my-api",
        "custom_domain": null,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "main_file": "src/index.js",
        "version": "recommended",
        "auto_restart": true,
        "start_command": "npm start",
        "use_credits": false,
        "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",
        "cluster": 1,
        "type": 1,
        "name": "my-postgres",
        "description": "PostgreSQL Database",
        "status": "up",
        "ram": 1024,
        "host": "v41806687fe6488884a464d1dc06692v.db.usa1.vertraweb.app",
        "port": 14523,
        "owner_id": "993591427428790342",
        "owner_plan_id": 3,
        "use_credits": true,
        "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"
      }
    ],
    "credits": {
      "compute": {
        "free": 450.5,
        "paid": 1200.0,
        "free_per_week": 2000,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      },
      "ai": {
        "free": 120.0,
        "paid": 500.0,
        "free_per_week": 500,
        "free_reset_at": "2026-04-01T00:00:00.000Z",
        "paid_expires_at": "2027-03-15T00:00:00.000Z"
      }
    },
    "created_at": "2026-01-15T01:26:04.784Z",
    "updated_at": "2026-03-19T22:10:31.220Z"
  }
}

Limitations Check Status

Documentation Index

​Response

Response