Get database
curl --request GET \
--url https://api.example.com/api/v1/databases/{id}Databases
Get database
Get details for a specific database.
GET
/
api
/
v1
/
databases
/
{id}
Get database
curl --request GET \
--url https://api.example.com/api/v1/databases/{id}Returns full details for a database.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.
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
curl -H "Authorization: Bearer dbh_your_api_key_here" \
https://dbhost.app/api/v1/databases/550e8400-e29b-41d4-a716-446655440000
Response
200 OK
{
"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 |
⌘I