---
title: "Resolve DNS records for a domain (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA)"
method: POST
path: "/dns-lookup.php"
tags: ["data"]
---

# Resolve DNS records for a domain (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA)

`POST /dns-lookup.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/dns-lookup.php`
- Auth: none declared

Query DNS records of the requested types via the system resolver. Records are returned as per-type arrays. Default types cover A, AAAA, MX, TXT, NS, CNAME, SOA, CAA. Also resolves reverse PTR records for A results when available. No SSRF risk - only resolves names; never connects from this server to the queried host.

## Request body

- object
  - `domain` string, required: Hostname (not URL). e.g. example.com
  - `types` string[]

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)