Skip to main content
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. 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

ParameterTypeDescription
iduuidDatabase 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

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key
404DATABASE_NOT_FOUNDDatabase doesn’t exist, isn’t owned by this user, or isn’t in scope for this key