# DNS Records

What Google's public resolver sees for one name — the answer status and every record of the asked type, A through CAA. An empty answer is data, not an error.

- Method: `GET`
- Path: `/v1/domains/dns/{domain}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `domain` | path segment | required | The name to resolve, e.g. `iix.web.id`. |
| `type` | string | optional | Record type: `A`, `AAAA`, `CAA`, `CNAME`, `MX`, `NS`, `SOA`, `SRV`, or `TXT`. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/domains/dns/%7Bdomain%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "domain": "iix.web.id",
    "type": "A",
    "status": "NOERROR",
    "records": [
      { "name": "iix.web.id.", "type": "A", "ttl": 300, "data": "104.21.47.52" },
      { "name": "iix.web.id.", "type": "A", "ttl": 300, "data": "172.67.144.141" }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T04:05:00.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-20T04:10:00.000Z"
  }
}
```