List databases

• 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
  }
}