Domain Event: nameserver_update
This event notification is generated when the nameservers set for a domain have changed.
Response Parameters for nameserver_update (domain)
If the request is successful, the attributes associative array may include the
following:
| Parameter name | Obligation | Definition/Value |
|---|---|---|
| nameserver_list | Always returned. | An array of nameservers, as set at the moment of this event. |
Response Example for nameserver_update (domain)
<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">EVENT</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
<item key="response_text">Command successful</item>
<item key="transaction_id">2014-06-19 11:32:29 27661 101</item>
<item key="action">REPLY</item>
<item key="attributes">
<dt_assoc>
<item key="events">
<dt_array>
<item key="0">
<dt_assoc>
<item key="object_data">
<dt_assoc>
<item key="domain_name">tucows-13e97b6ef1b1c.com</item>
<item key="domain_id">808369</item>
<item key="nameserver_list">
<dt_array>
<item key="0">parking1.mdnsservice.com</item>
<item key="1">parking2.mdnsservice.com</item>
</dt_array>
</item>
</dt_assoc>
</item>
<item key="object">DOMAIN</item>
<item key="event_id">b5eeb0e98f95563b72309755e0bfd172</item>
<item key="event">NAMESERVER_UPDATE</item>
<item key="event_date">2014-06-19T15:32:28Z</item>
</dt_assoc>
</item>
</dt_array>
</item>
<item key="total">2</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>{
"created_date" : "2026-07-15T23:52:00Z",
"id" : "823aec41-216d-416f-b80a-a77ee242247e",
"notification_type" : "opensrs.domain.nameserver_update",
"payload" : {
"@type" : "type.googleapis.com/google.protobuf.Struct",
"value" : {
"event" : "NAMESERVER_UPDATE",
"event_date" : "2026-07-15T23:52:00Z",
"event_id" : "a41d3a7a207f2c9c9cc7550893be63a0",
"object" : "DOMAIN",
"object_data" : {
"domain_id" : "98876632",
"domain_name" : "example.com",
"nameserver_list" : [
"sam.ns.cloudflare.com",
"teagan.ns.cloudflare.com"
]
}
}
}
}Updated 4 days ago
