---
title: "(Internal) Get a logical database"
method: GET
path: "/databases/{databaseId}"
tags: ["databases"]
---

# (Internal) Get a logical database

`GET /databases/{databaseId}`

## Request

- Base URL: `https://global.thenile.dev`
- URL: `https://global.thenile.dev/databases/{databaseId}`
- Auth: none declared

Gets details of a logical database from the data plane.

## Path parameters

- `databaseId` string, required

## Response `200`

Database details

- LogicalDatabase
  - `id` string, required
  - `name` string
  - `status` 'PENDING' | 'REQUESTED' | 'BUILT' | 'POOLED' | 'READY', required
  - `sharedPdb` PhysicalDatabase, required
    - `id` string, required
    - `regionId` integer, required
    - `pdbId` integer, required
  - `placementStrategy` 'RANDOM' | 'SINGLE', required

## Other responses

- `404`: Database not found

---

[API](https://skmtc.dev/thenile/apis/nile-rest-api.md) · [All operations](https://skmtc.dev/thenile/apis/nile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thenile/apis/nile-rest-api/revisions/afe849f2aeec?raw)