List databases

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.

• Full-account keys return all owned databases.
• Selected-database keys return only the databases assigned to that key.
• 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.

​

Example

curl -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases

​

Response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "my-app",
      "displayName": "My Application",
      "status": "active",
      "sizeBytes": 8388608,
      "createdAt": "2026-03-19T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}