Skip to main content

Registrar Lock

Get Registrar Lock​

GET /domains/{domain}/lock

Gets the registrar lock state for a domain.

Path variable:

  • domain: domain name, for example example.test.ly
Get registrar lock
curl --request GET \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/lock" \
  --header "username: [email protected]" \
  --header "token: <generated-token>"

HTTP 200 success response:

"unlocked"

Save Registrar Lock​

POST /domains/{domain}/lock

Locks or unlocks a domain to prevent it from being transferred away without authorization.

Path variable:

  • domain: domain name, for example example.test.ly

Request parameter:

  • lockstatus: allowed values are locked and unlocked

Complete Request​

curl --request POST \
  --url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/domains/example.test.ly/lock" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "username: [email protected]" \
  --header "token: <generated-token>" \
  --data-urlencode "lockstatus=locked"

Response​

The published OpenAPI declares HTTP 200 but does not define a response body or schema.

VALIDATION REQUIRED: Confirm the exact production response body returned by POST /domains/{domain}/lock.

Failure responses and whether lock support differs by TLD also require validation. This operation changes transfer controls; reconcile the lock state before retrying after an ambiguous failure.