# Domain Lookup

Is a domain registered or available, and who holds it — over RDAP, the standard built for exactly this, across any TLD IANA knows about, `.id` included.

- Method: `GET`
- Path: `/v1/domains/lookup`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `domain` | string | required | A fully qualified domain name, e.g. `toko-kita.id`. |
| `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/lookup \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "domain": "toko-kita.id",
    "available": false,
    "registrar": "PT Registrar Domain Indonesia",
    "created_at": "2021-03-02T00:00:00Z",
    "updated_at": "2026-02-14T00:00:00Z",
    "expires_at": "2027-03-02T00:00:00Z",
    "nameservers": ["ns1.example.net", "ns2.example.net"],
    "status": ["clientTransferProhibited"]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-19T13:05:00.000Z",
    "age_seconds": 12,
    "next_update_at": "2026-08-19T13:05:45.000Z"
  }
}
```