Database Data Overview - Vertra Cloud

curl https://api.vertracloud.app/v1/databases/{id}/data/overview \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "response": {
    "engine_version": "17.2",
    "size_bytes": 8437760,
    "objects_count": 12,
    "connections_active": 3,
    "connections_max": 100,
    "uptime_seconds": 84213
  }
}

GET

databases

{id}

data

overview

curl https://api.vertracloud.app/v1/databases/{id}/data/overview \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "response": {
    "engine_version": "17.2",
    "size_bytes": 8437760,
    "objects_count": 12,
    "connections_active": 3,
    "connections_max": 100,
    "uptime_seconds": 84213
  }
}

Every /data endpoint needs the Intermediary plan or higher, on the database owner’s account — not the caller’s. Below that the answer is PLAN_RESTRICTED_FEATURE (403). It is also dashboard-session only: an API key gets API_KEY_SCOPE_DENIED (403) here, regardless of its scopes.

Works for every engine. The shape is the same; only extra differs per engine.

string

required

The ID of the database.

string

Workspace the database belongs to. Required when the caller is not the owner.

Response

object

Show Toggle object

string

Version reported by the engine.

number

Data plus indexes, in bytes.

number

Tables (SQL), collections (MongoDB) or keys (Redis).

number

Connections open right now.

number

Connection ceiling. 0 when the engine has none.

number

Seconds since the engine started.

object

Engine-specific fields (replica_set, max_memory_bytes, …). Optional.

curl https://api.vertracloud.app/v1/databases/{id}/data/overview \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "response": {
    "engine_version": "17.2",
    "size_bytes": 8437760,
    "objects_count": 12,
    "connections_active": 3,
    "connections_max": 100,
    "uptime_seconds": 84213
  }
}

​Response

Response