FreeTLD Launch Calendar API
Get agenda
GET/agendaNo key
The whole public agenda of one month: industry events, TLD launch phases and registry changes.
The dated entries overlapping the month in date order, the registry announcements of the last 30 days without a day of their own (newest first), and the events without a date. Served whole (no cursor).
AccessNo key. Limited per address; a key adds the paid fields.
BillingOne call.
FormatsJSON
Request
monthstringOptionalQueryYYYY-MM, from the month of today minus 30 days to today plus 18 months; the current month by default.
categorystring: domaining, dns_governance, brand_ip, hosting_cloud, security_privacy, other_tech, launchesOptionalQueryAn event category, or launches for the TLD entries.
countrystringOptionalQueryISO 3166-1 alpha-2; filters events only.
tldstringOptionalQueryA bare root ending the catalog knows.
fieldsstringOptionalQueryComma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.
curl -X GET "https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot"
const response = await fetch("https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot", {
method: "GET",
});
const data = await response.json();
console.log(data);import requests
response = requests.get(
"https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot",
)
print(response.json())req, err := http.NewRequest("GET", "https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot", nil)
if err != nil {
panic(err)
}
res, err := http.DefaultClient.Do(req)$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($ch);uri = URI("https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot")
request = Net::HTTP::Get.new(uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }Response
entriesobject[]recentlyAddedobject[]undatedobject[]Errors
{
"data": {
"entries": [
{
"id": "8c4e2f10-3b6a-4d7e-a1f9-6e2b5c8d0a37",
"kind": "tld_phase",
"title": ".bot general availability",
"startsOn": "2026-11-12",
"endsOn": null,
"category": "launches",
"countryCode": null,
"city": null,
"lat": null,
"lng": null,
"tld": "bot"
}
],
"recentlyAdded": [],
"undated": []
},
"meta": {
"asOf": "2026-11-05T08:00:00Z",
"cursor": null,
"limit": null
},
"links": {
"self": "https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot",
"next": null,
"register": null,
"product": null,
"dataset": null
}
}