Get Locks Info

Retrieve the registrar lock status for all Namecheap domains.

What This Does

This endpoint retrieves the registrar lock status for all Namecheap domains across your connected Namecheap accounts. Unlike the Get Lock Info endpoint which checks one domain at a time, this provides bulk lock status information for your entire Namecheap portfolio.

What You Need

To use this endpoint, you need:

  1. A valid Limited Access Key (LAK) with “read” permissions
  2. The password for your LAK
  3. At least one Namecheap domain that your LAK has access to

Endpoint

https://api.nerve.io/v1/domains/locks

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

How to Make a Request

To gather lock status information for all your Namecheap domains, 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 may be added in future updates. For accounts with thousands of domains, the response time may take several minutes due to automatic pagination.

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": true,
      "Errors": [],
      "Warnings": []
    },
    {
      "domain": "anotherdomain.com",
      "locked": false,
      "Errors": [],
      "Warnings": []
    }
  ]
}

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/v1/domains/locks" n  -H "X-Nerve-Access-Key: YOUR_ACCESS_KEY" n  -H "X-Nerve-Password: YOUR_PASSWORD"

Let AI Code For You

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