---
layout: page
title: "Whois Sensor"
description: "Instructions on how to integrate WHOIS lookup sensor within Home Assistant."
date: 2017-10-22 00:00
sidebar: true
comments: false
sharing: true
footer: true
logo: icann.png
ha_category: Network
ha_release: "0.57"
ha_iot_class: "Cloud Polling"
---


The `whois` sensor platform allows you to perform daily WHOIS lookups against your owned domains. This provides you with information such as `expiration_date`, `name_servers` and `registrar` details.

## {% linkable_title Configuration %}

To use this sensor in your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
sensor:
  - platform: whois
    domain: example.net
```

{% configuration %}
  domain:
    description: The domain you want to perform WHOIS lookups against.
    required: true
    type: string
  name:
    description: Name to use in the frontend.
    required: false
    default: Whois
    type: string
{% endconfiguration %}