# Function: describeHost()

```ts
function describeHost(url, timeoutMs?): Promise<HostDescription>;
```

Defined in: [packages/core/src/session/hosting.ts:643](https://github.com/leifriksheim/minca/blob/main/core/src/session/hosting.ts#L643)

What a host at an address says about itself.

## Parameters

| Parameter | Type | Default value |
| ------ | ------ | ------ |
| `url` | `string` | `undefined` |
| `timeoutMs?` | `number` | `HOST_TIMEOUT_MS` |

## Returns

`Promise`\<[`HostDescription`](https://minca.dev/api/core/interfaces/HostDescription.md)\>