Create domain

cURL

curl --request POST \
  --url https://domainwarden.app/api/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com",
  "label": "My Website",
  "description": "Production website for client XYZ",
  "colour": "#3B82F6",
  "whois_check_interval": "daily",
  "dns_check_interval": "hourly",
  "enabled_dns_records": [
    "A",
    "AAAA",
    "MX",
    "TXT"
  ]
}
'

{
  "data": [
    {
      "id": "019a11e5-3072-707a-82b2-91bf8b940e80",
      "label": "My Website",
      "domain": "example.com",
      "description": "Production website for client XYZ",
      "colour": "#3B82F6",
      "provider": null,
      "expires_at": null,
      "components": {
        "whois": {
          "is_enabled": true,
          "check_interval": "daily",
          "check_status": "PENDING",
          "latest_check_details": null,
          "last_checked_at": null,
          "next_check_at": null,
          "last_manual_check_at": null,
          "changes_detected_at": null,
          "has_changed_recently": false,
          "was_manually_checked_recently": false
        },
        "dns": {
          "is_enabled": true,
          "check_interval": "hourly",
          "check_status": "PENDING",
          "latest_check_details": null,
          "last_checked_at": null,
          "next_check_at": null,
          "last_manual_check_at": null,
          "changes_detected_at": null,
          "has_changed_recently": false,
          "was_manually_checked_recently": false,
          "enabled_records": [
            "A",
            "AAAA",
            "MX",
            "TXT"
          ]
        },
        "ssl": {
          "is_enabled": true,
          "issuer": null,
          "organization": null,
          "expires_at": null,
          "last_checked_at": null,
          "last_found_invalid_at": null,
          "last_considered_valid_at": null,
          "has_changed_recently": false
        }
      },
      "created_at": "2025-10-25 12:30:45",
      "updated_at": "2025-10-25 12:30:45"
    }
  ]
}

POST

api

domains

cURL

curl --request POST \
  --url https://domainwarden.app/api/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com",
  "label": "My Website",
  "description": "Production website for client XYZ",
  "colour": "#3B82F6",
  "whois_check_interval": "daily",
  "dns_check_interval": "hourly",
  "enabled_dns_records": [
    "A",
    "AAAA",
    "MX",
    "TXT"
  ]
}
'

{
  "data": [
    {
      "id": "019a11e5-3072-707a-82b2-91bf8b940e80",
      "label": "My Website",
      "domain": "example.com",
      "description": "Production website for client XYZ",
      "colour": "#3B82F6",
      "provider": null,
      "expires_at": null,
      "components": {
        "whois": {
          "is_enabled": true,
          "check_interval": "daily",
          "check_status": "PENDING",
          "latest_check_details": null,
          "last_checked_at": null,
          "next_check_at": null,
          "last_manual_check_at": null,
          "changes_detected_at": null,
          "has_changed_recently": false,
          "was_manually_checked_recently": false
        },
        "dns": {
          "is_enabled": true,
          "check_interval": "hourly",
          "check_status": "PENDING",
          "latest_check_details": null,
          "last_checked_at": null,
          "next_check_at": null,
          "last_manual_check_at": null,
          "changes_detected_at": null,
          "has_changed_recently": false,
          "was_manually_checked_recently": false,
          "enabled_records": [
            "A",
            "AAAA",
            "MX",
            "TXT"
          ]
        },
        "ssl": {
          "is_enabled": true,
          "issuer": null,
          "organization": null,
          "expires_at": null,
          "last_checked_at": null,
          "last_found_invalid_at": null,
          "last_considered_valid_at": null,
          "has_changed_recently": false
        }
      },
      "created_at": "2025-10-25 12:30:45",
      "updated_at": "2025-10-25 12:30:45"
    }
  ]
}

Authorizations

Authorization

string

header

required

You can obtain your API Token from your Domainwarden account settings.

Body

application/json

domain

string

required

The domain name to monitor (e.g., example.com). Must be between 3 and 100 characters and follow valid domain format.

Example:

"example.com"

label

string

required

A friendly label for the domain. Must be between 3 and 40 characters.

Example:

"My Website"

description

string | null

optional A description of the domain. Maximum 1000 characters.

Example:

"Production website for client XYZ"

colour

string | null

optional Hex color code for the domain (e.g., #FF5733 or #F57).

Example:

"#3B82F6"

whois_check_interval

string | null

optional How often to check WHOIS records. Available options depend on subscription plan.

Example:

"daily"

dns_check_interval

string | null

optional How often to check DNS records. Available options depend on subscription plan.

Example:

"hourly"

enabled_dns_records

string[]

optional DNS record types to monitor.

Example:

["A", "AAAA", "MX", "TXT"]

Response

data

object[]

Show child attributes

data.id

string

Example:

"019a11e5-3072-707a-82b2-91bf8b940e80"

data.label

string

Example:

"My Website"

data.domain

string

Example:

"example.com"

data.description

string

Example:

"Production website for client XYZ"

data.colour

string

Example:

"#3B82F6"

data.provider

string

Example:

null

data.expires_at

string

Example:

null

data.components

object

Show child attributes

data.components.whois

object

Show child attributes

data.components.whois.is_enabled

boolean

Example:

true

data.components.whois.check_interval

string

Example:

"daily"

data.components.whois.check_status

string

Example:

"PENDING"

data.components.whois.latest_check_details

string

Example:

null

data.components.whois.last_checked_at

string

Example:

null

data.components.whois.next_check_at

string

Example:

null

data.components.whois.last_manual_check_at

string

Example:

null

data.components.whois.changes_detected_at

string

Example:

null

data.components.whois.has_changed_recently

boolean

Example:

false

data.components.whois.was_manually_checked_recently

boolean

Example:

false

data.components.dns

object

Show child attributes

data.components.dns.is_enabled

boolean

Example:

true

data.components.dns.check_interval

string

Example:

"hourly"

data.components.dns.check_status

string

Example:

"PENDING"

data.components.dns.latest_check_details

string

Example:

null

data.components.dns.last_checked_at

string

Example:

null

data.components.dns.next_check_at

string

Example:

null

data.components.dns.last_manual_check_at

string

Example:

null

data.components.dns.changes_detected_at

string

Example:

null

data.components.dns.has_changed_recently

boolean

Example:

false

data.components.dns.was_manually_checked_recently

boolean

Example:

false

data.components.dns.enabled_records

string[]

Example:

["A", "AAAA", "MX", "TXT"]

data.components.ssl

object

Show child attributes

data.components.ssl.is_enabled

boolean

Example:

true

data.components.ssl.issuer

string

Example:

null

data.components.ssl.organization

string

Example:

null

data.components.ssl.expires_at

string

Example:

null

data.components.ssl.last_checked_at

string

Example:

null

data.components.ssl.last_found_invalid_at

string

Example:

null

data.components.ssl.last_considered_valid_at

string

Example:

null

data.components.ssl.has_changed_recently

boolean

Example:

false

data.created_at

string

Example:

"2025-10-25 12:30:45"

data.updated_at

string

Example:

"2025-10-25 12:30:45"

Example:

[
  {
    "id": "019a11e5-3072-707a-82b2-91bf8b940e80",
    "label": "My Website",
    "domain": "example.com",
    "description": "Production website for client XYZ",
    "colour": "#3B82F6",
    "provider": null,
    "expires_at": null,
    "components": {
      "whois": {
        "is_enabled": true,
        "check_interval": "daily",
        "check_status": "PENDING",
        "latest_check_details": null,
        "last_checked_at": null,
        "next_check_at": null,
        "last_manual_check_at": null,
        "changes_detected_at": null,
        "has_changed_recently": false,
        "was_manually_checked_recently": false
      },
      "dns": {
        "is_enabled": true,
        "check_interval": "hourly",
        "check_status": "PENDING",
        "latest_check_details": null,
        "last_checked_at": null,
        "next_check_at": null,
        "last_manual_check_at": null,
        "changes_detected_at": null,
        "has_changed_recently": false,
        "was_manually_checked_recently": false,
        "enabled_records": ["A", "AAAA", "MX", "TXT"]
      },
      "ssl": {
        "is_enabled": true,
        "issuer": null,
        "organization": null,
        "expires_at": null,
        "last_checked_at": null,
        "last_found_invalid_at": null,
        "last_considered_valid_at": null,
        "has_changed_recently": false
      }
    },
    "created_at": "2025-10-25 12:30:45",
    "updated_at": "2025-10-25 12:30:45"
  }
]

List domains Get domain

⌘I

API documentation

Domains

User

Authorizations

Body

Response