Get Lock Info

Retrieve the registrar lock status for a specific domain at Namecheap.

What This Does

Use this endpoint when the locked field is null (unknown) in a List Domains endpoint response and you need a verified lock status for a specific Namecheap domain.

Endpoint

https://api.nerve.io/api/v1/domains/{domain}/lock

Headers

All API requests require these authentication headers:

X-Nerve-Access-Key
Your Limited Access Key

Required

X-Nerve-Password
The password for your LAK

Required

Query Parameters

{domain}
The domain name

Required

How to Make a Request

To gather information about your domain(s), send a request to the endpoint using your Limited Access Key and password in the headers.

Example requests can be made with tools like cURL, Postman, or your preferred programming language. Or you can use select a Limited Access Key from the pulldown and press the “Run” button to see the results on this page.

Limitations

This endpoint currently supports Namecheap domains only. Other registrars include lock state in their bulk responses or via different APIs.

Response Codes

Response codes tell you whether the request worked or not.

200 means success. Codes in the 400s mean something was wrong with the request (e.g., missing or invalid access key). 429 means you are being rate limited. 500 means the server had a problem.

The status is determined by the API when it tries to process your request and is returned with every response.

{
  "result": [
    {
      "domain": "example.com",
      "locked": false,
      "Errors": [],
      "Warnings": [],
      "DomainGetRegistrarLockResult": {
        "@attributes": {
          "Domain": "domaining.lol",
          "RegistrarLockStatus": "false",
          "IsClientUpdateProhibited": "false",
          "IsClientDeleteProhibited": "false",
          "IsClientHold": "false"
        }
      }
    }
  ]
}

After signing in and selecting a LAK, you can quickly fill in your key and password using the tool on the right (or below on mobile).

curl -X GET "https://api.nerve.io/api/v1/domains/{domain}/lock" \
   -H "X-Nerve-Access-Key: YOUR_ACCESS_KEY" \
   -H "X-Nerve-Password: YOUR_PASSWORD"

Let AI Code For You

Copy this prompt and use it with your favorite AI assistant.