> For the complete documentation index, see [llms.txt](https://bmsvieira.gitbook.io/nova-irc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bmsvieira.gitbook.io/nova-irc/methods/whois.md).

# whois

The `whois`  method returns an object with the current list of bans.

#### Syntax and example usage

```javascript
bot.whois('NICKNAME').then((whoisData) => {

}).catch((err) => {

});
```

#### Parameters

* **`nickname`** *(string, required)* – The nickname of the user you want to retrieve all the whois information.

#### Example Usage

```javascript
bot.whois('NICKNAME').then((whoisData) => {

   // Object with all whois information
   console.log(whoisData);

})
.catch((err) => {
    console.error('WHOIS error:', err);
});
```

#### Response structure

```json
{
    nick: "",
    username: "",
    host: "",
    realName: "",
    server: "",
    serverInfo: "",
    idleTime: "",
    channels: [],
    isOperator: "",
    isRegistered: ""
}
```

**Notes**

* Ensure the channel name starts with `#`.
* The bot must have sufficient permissions (usually operator or higher) 
* The user must be present in the channel

4o mini