---
title: "Get a database."
method: GET
path: "/v1/databases/{id}"
tags: ["Database"]
---

# Get a database.

`GET /v1/databases/{id}`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/databases/{id}`
- Auth: HTTP bearer

Fetches one database by id, including its PostgreSQL version and isolation tier.

## Path parameters

- `id` string, required

## Response `200`

The database

- DatabaseJson: A ScalixNova database record.
  - `id` string, required: Database id (UUID).
  - `name` string, required: Display name.
  - `pg_database` string, nullable: Physical PostgreSQL database name (`db_<hex>`).
  - `tenant_id` string, nullable: Tenant id backing this database on the compute plane.
  - `status` string, required: `active` or `deleting` (soft-deleted, inside the recovery grace window).
  - `created_at` string, nullable: RFC 3339 creation time.
  - `isolation` string, required: Isolation tier: `shared` or `dedicated`.
  - `pg_version` string, required: PostgreSQL major version this database runs (`16`, `17`, or `18`).
  - `deleted_at` string, nullable: Soft-delete timestamp, when `status` is `deleting`.

## Other responses

- `401`: Missing or invalid API key
- `404`: Database not found

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)