Skip to main content
GET
/
api
/
domains
/
{domain_id}
/
changes
/
dns
cURL
curl --request GET \
  --url https://domainwarden.app/api/domains/{domain_id}/changes/dns \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "019a11e5-1234-5678-9012-123456789012",
      "domain_id": 1,
      "field_changed": "a_records",
      "field_changed_human": "A",
      "old_value": "[{\"host\":\"@\",\"value\":\"192.0.2.1\",\"ttl\":3600}]",
      "new_value": "[{\"host\":\"@\",\"value\":\"192.0.2.2\",\"ttl\":3600}]",
      "old_value_formatted": "192.0.2.1",
      "new_value_formatted": "192.0.2.2",
      "change_summary": "A record updated",
      "diff": "Changed from 192.0.2.1 to 192.0.2.2",
      "identifier": "abc123def456",
      "created_at": "2024-10-27 12:00:00",
      "created_at_human": "2 hours ago"
    },
    {
      "id": "019a11e5-5678-1234-9012-987654321012",
      "domain_id": 1,
      "field_changed": "mx_records",
      "field_changed_human": "MX",
      "old_value": "[{\"host\":\"@\",\"value\":\"mail.old.com\",\"priority\":10,\"ttl\":3600}]",
      "new_value": "[{\"host\":\"@\",\"value\":\"mail.new.com\",\"priority\":10,\"ttl\":3600}]",
      "old_value_formatted": "mail.old.com (Priority: 10)",
      "new_value_formatted": "mail.new.com (Priority: 10)",
      "change_summary": "MX record updated",
      "diff": "Mail server changed from mail.old.com to mail.new.com",
      "identifier": "xyz789ghi012",
      "created_at": "2024-10-26 08:30:00",
      "created_at_human": "1 day ago"
    }
  ],
  "links": {
    "first": "http://example.com/api/domain/1/changes/dns?page=1",
    "last": "http://example.com/api/domain/1/changes/dns?page=3",
    "prev": null,
    "next": "http://example.com/api/domain/1/changes/dns?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 3,
    "per_page": 15,
    "to": 15,
    "total": 42
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

domain_id
string
required

The ID of the domain.

domain
integer
required

The ID of the domain.

Query Parameters

per_page
integer

Number of items per page (default: 15, max: 100).

Example:

20

page
integer

Page number for pagination.

Example:

1

Response

data
object[]
Example:
[
{
"id": "019a11e5-1234-5678-9012-123456789012",
"domain_id": 1,
"field_changed": "a_records",
"field_changed_human": "A",
"old_value": "[{\"host\":\"@\",\"value\":\"192.0.2.1\",\"ttl\":3600}]",
"new_value": "[{\"host\":\"@\",\"value\":\"192.0.2.2\",\"ttl\":3600}]",
"old_value_formatted": "192.0.2.1",
"new_value_formatted": "192.0.2.2",
"change_summary": "A record updated",
"diff": "Changed from 192.0.2.1 to 192.0.2.2",
"identifier": "abc123def456",
"created_at": "2024-10-27 12:00:00",
"created_at_human": "2 hours ago"
},
{
"id": "019a11e5-5678-1234-9012-987654321012",
"domain_id": 1,
"field_changed": "mx_records",
"field_changed_human": "MX",
"old_value": "[{\"host\":\"@\",\"value\":\"mail.old.com\",\"priority\":10,\"ttl\":3600}]",
"new_value": "[{\"host\":\"@\",\"value\":\"mail.new.com\",\"priority\":10,\"ttl\":3600}]",
"old_value_formatted": "mail.old.com (Priority: 10)",
"new_value_formatted": "mail.new.com (Priority: 10)",
"change_summary": "MX record updated",
"diff": "Mail server changed from mail.old.com to mail.new.com",
"identifier": "xyz789ghi012",
"created_at": "2024-10-26 08:30:00",
"created_at_human": "1 day ago"
}
]
meta
object