> For the complete documentation index, see [llms.txt](https://docs.halosecurity.com/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.halosecurity.com/api/endpoints/dns.md).

# DNS

## Get a list of DNS records

<mark style="color:blue;">`GET`</mark> `https://api.halosecurity.com/api/v1/dns/list.json`

Returns a paginated list of DNS records.

<https://app.halosecurity.com/user/security/firewall/dns/list>

#### Query Parameters

| Name       | Type    | Description                                                              |
| ---------- | ------- | ------------------------------------------------------------------------ |
| sort       | String  | <p><code>0</code></p><p>= none (default)</p>                             |
| sort\_desc | Integer | <p><code>0</code> = No <em>(default)</em></p><p><code>1</code> = Yes</p> |
| type       | String  | Filter by type                                                           |
| value      | String  | Filter by value                                                          |
| host       | String  | Filter by host                                                           |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "list": [
        {
            "record": {
                "host": "www.example.com",
                "type": "a",
                "value": "0.0.0.0"
            },
            "target": {
                "target_name": "",
                "target_id": 1,
                "target": "www.example.com"
            }
        }
    ]
}
```

{% endtab %}
{% endtabs %}