> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dnsradar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Monitor your DNS records and get notified when they change

## Welcome to DNSRadar API

DNSRadar is a powerful DNS monitoring service that helps you track changes to your DNS records in real-time. Whether you're managing critical infrastructure, monitoring for security threats, or ensuring DNS propagation, our API provides the tools you need to stay informed.

## What is DNSRadar?

DNSRadar continuously monitors your DNS records and alerts you immediately when changes occur. Track A, AAAA, CNAME, MX, TXT, NS, and other record types with configurable check frequencies from 5 to 120 minutes.

## Key Features

<CardGroup cols={2}>
  <Card title="Real-Time Monitoring" icon="radar">
    Track DNS records with check frequencies as low as 5 minutes
  </Card>

  <Card title="Change Detection" icon="bell">
    Get instant notifications when your DNS records change
  </Card>

  <Card title="Event History" icon="clock-rotate-left">
    Access complete history of all DNS changes detected
  </Card>

  <Card title="Webhook Integration" icon="webhook">
    Integrate with your existing workflows using webhooks
  </Card>

  <Card title="Bulk Operations" icon="layer-group">
    Create and manage up to 1000 monitors at once
  </Card>

  <Card title="Organized Monitoring" icon="folder-tree">
    Group monitors for better organization and management
  </Card>
</CardGroup>

## Getting Started

Get up and running with DNSRadar in minutes:

<Steps>
  <Step title="Get Your API Key">
    Sign up at [dashboard.dnsradar.dev](https://dashboard.dnsradar.dev) and generate your API key
  </Step>

  <Step title="Authenticate">
    Include your API key in the `X-Api-Key` header with every request
  </Step>

  <Step title="Create a Monitor">
    Set up your first DNS monitor to track changes to your records
  </Step>

  <Step title="Configure Webhooks">
    Add webhook endpoints to receive notifications when changes occur
  </Step>
</Steps>

## Quick Example

Here's how to create your first DNS monitor:

```bash theme={null}
curl -X POST https://api.dnsradar.dev/monitors \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "subdomain": "www",
    "record_type": "A",
    "expected_value": ["192.168.1.1"],
    "frequency": 60
  }'
```

## Use Cases

* **Security Monitoring**: Detect unauthorized DNS changes that could indicate hijacking attempts
* **Infrastructure Management**: Track DNS propagation and ensure your records are configured correctly
* **Compliance**: Maintain audit trails of all DNS changes for compliance requirements
* **DevOps Integration**: Automate DNS monitoring as part of your deployment pipelines
* **Multi-Team Coordination**: Share monitoring responsibilities across teams with grouped monitors

## API Overview

The DNSRadar API is organized around REST principles with predictable resource-oriented URLs. We use standard HTTP response codes, authentication, and verbs. All API responses are returned in JSON format.

**Base URL**: `https://api.dnsradar.dev`

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/docs/openapi">
    Explore all available endpoints and parameters
  </Card>

  <Card title="Authentication" icon="key" href="/docs/authentication">
    Learn how to authenticate your API requests
  </Card>

  <Card title="Support" icon="life-ring" href="mailto:support@dnsradar.dev">
    Get help from our support team
  </Card>

  <Card title="Dashboard" icon="gauge" href="https://dashboard.dnsradar.dev">
    Manage your monitors via web interface
  </Card>
</CardGroup>
