> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dbhost.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get database

> Get details for a specific database.

Returns full details for a database.

`sizeBytes` reflects the latest known PostgreSQL database size. When the agent is reachable, DBHost refreshes this from live agent data before responding and also persists the refreshed value for later reads.
`status` can be `creating`, `active`, `stopped`, `deleting`, or `error`.

## Path parameters

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id`      | uuid | Database ID |

## Example

```bash theme={null}
curl -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases/550e8400-e29b-41d4-a716-446655440000
```

## Response

```json 200 OK theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-app",
  "displayName": "My Application",
  "host": "db.dbhost.app",
  "port": 6432,
  "database": "my-app",
  "username": "my-app",
  "status": "active",
  "sizeBytes": 8388608,
  "createdAt": "2026-03-19T12:00:00.000Z"
}
```

## Errors

| Status | Code                 | Description                                                                      |
| ------ | -------------------- | -------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`       | Missing or invalid API key                                                       |
| 404    | `DATABASE_NOT_FOUND` | Database doesn't exist, isn't owned by this user, or isn't in scope for this key |