Registrar Lock (Enable/Disable)

Managing Registrar Locks: Controls the "Transfer Lock" status of the domain via a synchronous upstream API call. Enabling the lock prevents unauthorized transfer attempts by other registrars. To begin fetching the EPP Code or facilitating an outward transfer, you must first call the /unlock endpoint to drop the transfer prohibition flags.

Endpoints:

  • POST /{id}/lock: Enable the registrar lock to trigger the clientTransferProhibited state.
  • POST /{id}/unlock: Disable the lock to clear constraints and allow a transfer.

Parameters:

  • id (required, URL parameter): The local ID of the domain

Example Request (Enable Lock):

curl -X POST "https://umva.net/api/domain/123/lock" 
  -H "X-API-Key: your_api_key_here"

Success Response Example (HTTP 200):

{
  "success": true,
  "message": "Registrar lock enabled successfully.",
  "data": {
    "domain": "example.com",
    "registrar_lock": true
  }
}

Error Response Example (HTTP 500):

{
  "success": false,
  "message": "Domain is already locked."
}