Skip to main content

Delete a domain

This endpoint allows you to delete a domain

Endpoint

DELETE /registrar/v1/domains/{domain}

Parameters

NameLocationRequiredTypeDefault valueDescription
domainURLYesStringA complete domain name
abandonTypeBodyNoStringThe wished abandon type.

You can choose between the following options :

  • NOW : the domain will be abandoned when you’ll call this function.
  • EXPIRATION : the domain will be abandoned on its expiration date.
  • ATDATE : allows you to abandon the domain at a specified date.
  • CANCEL : allows you to cancel an abandon request. (if ‘type’ was not NOW)

If field is empty, EXPIRATION is set by default.

abandonDateBodyNo/YesStringThis field is mandatory only if you choose the ‘ATDATE’ type. You must specify a date using the following syntax yyyy-mm-dd. Example : 2012-12-25

Response

Delete domain

Example Request

DELETE /registrar/v1/domains/exemple.com
Content-Type: application/json
Body
{
"abandonType": "ATDATE",
"abandonDate": "2024-12-15"
}

Example Response

{
"message": "Ok"
}