> For the complete documentation index, see [llms.txt](https://docs.dappling.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dappling.network/api/domains-domain.md).

# /domains/{domain}

## Request

The request object must be formatted as a GET request. The only required header is for [Authentication](/api.md#authentication). 

### Parameters

The queried domain must be appended to the end of the url as a full root domain (e.g. <https://dappling.network/api/v1/domains/dappling.fi>).

### Examples

```powershell
curl --location 'https://dappling.network/api/v1/domains/dappling.fi' \
--header 'Authorization: {DAPPLING_AUTH_TOKEN}'
```

```javascript
const myHeaders = new Headers();
myHeaders.append("Authorization", {DAPPLING_AUTH_TOKEN});

const requestOptions = {
  method: "GET",
  headers: myHeaders,
};

fetch("https://dappling.network/api/v1/domains/dappling.fi", requestOptions)
  .then((response) => response.json())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

## Response

The /domains/{domain} endpoint returns a 200 status code with the domain object.

### Structure

* **domain**: domain name of the record
* **Nameservers:** an array that contains objects with details about the nameservers associated with the domain
  * Within each "Nameservers" object:
    * **updatedAt:** the last update time of the nameserver records for the domain
    * **records:** an array of strings, each representing a nameserver record associated with the domain. These are the addresses of the DNS servers that manage the DNS records for the domain.

### Example

```
{
  "domain": "dappling.fi",
  "Nameservers": [
    {
      "updatedAt": "2024-03-07T04:21:12.193Z",
      "records": [
        "ns-1325.awsdns-37.org.",
        "ns-1809.awsdns-34.co.uk.",
        "ns-456.awsdns-57.com.",
        "ns-581.awsdns-08.net."
      ]
    }
  ]
}
```

### Errors

If the dAppling database is not tracking a particular domain, it will return a 404 Not Found error.

:cactus:*Fun Fact: Some species of bamboo can grow up to 91 cm (36 in) within a 24-hour period, making it one of the fastest-growing plants in the world.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dappling.network/api/domains-domain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.