Domains-domainName-lock:GET

From Hostway API Documentation
Jump to: navigation, search

GET /domains/{domainName}/lock

Get the current lock status of a domain. This corresponds to a status of 'clientTransferProhibited' at the registry. A domain name with this status cannot be transferred to another registrar but may be renewed and it may be modified; such as changes to the name servers or contact info.

Contents

Request

GET /domains/{domainName}/lock

Parameters

domainName - string
The domain name. IE: example.com is a valid domain name, whereas http://www.example.com or www.example.com are not. If the domain name is invalid, or is otherwise not registerable such as for a non-existent or non-supported TLD, an error will be returned. Domain names are case insensitive. The domain name must be an open or suspended product under the authenticated franchise.

URI Parameters

None.

Request Headers

None.

Request Body

None.

Response

Status Code

200 OK
Returns the domain lock status.
400 Bad Request
The domain name is not valid.
403 Forbidden
Domain is not registered in this account and cannot be accessed.
404 Not Found
No domain records found for the given domain name.


Response Body

true
Means that domain lock status is set, domain is locked.
false
Means that domain lock status is not set, domain is unlocked.

Example of getting the domain lock status.

Request

GET /domains/example.com/lock

 

Response

200 OK
Content-Type: application/json; charset=UTF-8

true
 

See also


blog comments powered by Disqus

Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox