> ## 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.

# List databases

> Get the databases visible to the authenticated API key.

Returns the databases visible to the authenticated API key, ordered by creation date (newest first).

* 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

```bash theme={null}
curl -H "Authorization: Bearer dbh_your_api_key_here" \
  https://dbhost.app/api/v1/databases
```

## Response

```json 200 OK theme={null}
{
  "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
  }
}
```

`data` is empty if the key has no visible databases.