# API01004: DNS Resolution Failed

## What This Means[​](#what-this-means "Direct link to What This Means")

The POS could not convert your website's domain name (e.g., `yourstore.com`) into an IP address. DNS (Domain Name System) is like the internet's phone book — if it can't find the listing, it can't make the connection.

## Common Causes[​](#common-causes "Direct link to Common Causes")

* **Typo in domain name** — The URL may have a spelling error
* **DNS server issues** — Your DNS server is not responding
* **Domain expired** — The domain registration may have lapsed
* **DNS propagation** — Recent DNS changes haven't propagated yet
* **Local DNS cache** — Outdated DNS information cached on your device

## How to Fix[​](#how-to-fix "Direct link to How to Fix")

### 1. Verify the Domain Name[​](#1-verify-the-domain-name "Direct link to 1. Verify the Domain Name")

Double-check the URL for typos. Try accessing the site in a browser.

### 2. Check Domain Status[​](#2-check-domain-status "Direct link to 2. Check Domain Status")

Use a WHOIS lookup to verify:

* The domain is still registered
* It hasn't expired
* DNS records are configured

### 3. Clear DNS Cache[​](#3-clear-dns-cache "Direct link to 3. Clear DNS Cache")

**On your device:**

macOS:

```
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
```

Windows:

```
ipconfig /flushdns
```

### 4. Try Alternative DNS[​](#4-try-alternative-dns "Direct link to 4. Try Alternative DNS")

Switch to a public DNS server like:

* Google: `8.8.8.8` and `8.8.4.4`
* Cloudflare: `1.1.1.1`

### 5. Wait for DNS Propagation[​](#5-wait-for-dns-propagation "Direct link to 5. Wait for DNS Propagation")

If you recently changed DNS settings, wait 24-48 hours for full propagation.

## Related Errors[​](#related-errors "Direct link to Related Errors")

* [API01006](/error-codes/API01006.md) — Network Unreachable
* [API06001](/error-codes/API06001.md) — Invalid URL Format