---
title: "Get database information"
method: GET
path: "/v2/databases/{databaseId}"
tags: ["DB Lifecycle"]
---

# Get database information

`GET /v2/databases/{databaseId}`

Returns the database identity, region, type, allocated memory, and connection port.

## Path parameters

- `databaseId` string, required

## Response `200`

Database metadata.

- object
  - `status` 'success', required
  - `response` Database, required
    - `id` string, required — 24-char hex database identifier.
    - `name` string, required — Display name.
    - `owner` string, required — User identifier of the database owner.
    - `cluster` string, required — Cluster identifier the database is hosted on.
    - `ram` integer, required — Allocated memory in MB.
    - `type` 'mongo' | 'mysql' | 'redis' | 'postgres', required — Database engine slug.
    - `port` integer, required — TCP port the database listens on.
    - `created_at` string, date-time, required

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The database does not exist or is not owned by the caller.
- `429` — The authenticated user or API key exceeded the global request budget.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)