---
title: "Searches for an active DHCP server on the network"
method: POST
path: "/dhcp/find_active_dhcp"
tags: ["dhcp"]
---

# Searches for an active DHCP server on the network

`POST /dhcp/find_active_dhcp`

## Request

- Base URL: `/control` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/control/dhcp/find_active_dhcp`
- Auth: HTTP basic

## Request body

- DhcpFindActiveReq: Request for checking for other DHCP servers in the network.
  - `interface` string: The name of the network interface

## Response `200`

OK.

- DhcpSearchResult: Information about a DHCP server discovered in the current network.
  - `v4` DhcpSearchV4
    - `other_server` DhcpSearchResultOtherServer
      - `found` 'yes' | 'no' | 'error': The result of searching the other DHCP server.
      - `error` string: Set if found=error
    - `static_ip` DhcpSearchResultStaticIP
      - `static` 'yes' | 'no' | 'error': The result of determining static IP address.
      - `ip` string: Set if static=no
  - `v6` DhcpSearchV6
    - `other_server` DhcpSearchResultOtherServer
      - `found` 'yes' | 'no' | 'error': The result of searching the other DHCP server.
      - `error` string: Set if found=error

## Other responses

- `501`: Not implemented (for example, on Windows).

## Changes

- **2026-07-17** `14ff21aeb363`: 1 info
  - added optional request body
- **2023-03-26** `aecca8e1fa4f`: 1 breaking
  - removed the request body

[Operation history](https://skmtc.dev/guardllamanet/apis/adguard-home/changes/dhcp/find_active_dhcp/post.md)

---

[API](https://skmtc.dev/guardllamanet/apis/adguard-home.md) - [All operations](https://skmtc.dev/guardllamanet/apis/adguard-home/llms.txt) - [OpenAPI document](https://skmtc.dev/guardllamanet/apis/adguard-home/revisions/14ff21aeb363?raw)