> For the complete documentation index, see [llms.txt](https://tomi-domain-name-service.gitbook.io/titled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tomi-domain-name-service.gitbook.io/titled/subgraph/query-examples.md).

# Query Examples

sidebar\_position: 3 title: Sample Queries

***

## Querying

Below are some sample queries you can use to gather information from the Domains contracts.

You can build your own queries using a GraphQL Explorer and enter your endpoint to limit the data to exactly what you need.

### Get the top domain for an account based on the longest registry.

```graphql
query getDomainForAccount {
  account(id: "0xa508c16666c5b8981fa46eb32784fccc01942a71") {
    registrations(first: 1, orderBy: expiryDate, orderDirection: desc) {
      domain {
        name
      }
    }
    id
  }
}
```

#### Returns

```graphql
{
  "data": {
    "account": {
      "registrations": [
        {
          "domain": {
            "name": "datanexus.tomi"
          }
        }
      ],
      "id": "0xa508c16666c5b8981fa46eb32784fccc01942a71"
    }
  }
}
```

### Search for subdomain

```graphql
query getSubDomains($Account: String = "messari.tomi") {
  domains(where: { name: "messari.tomi" }) {
    name
    id
    subdomains(first: 10) {
      name
    }
    subdomainCount
  }
}
```

#### Returns

```graphql
{
  "data": {
    "domains": [
      {
        "name": "messari.tomi",
        "id": "0x498ada62251a1227664ace8d97b0de2dcc6652ddf61e6fb5d3150f43ccf599e6",
        "subdomains": [
          {
            "name": "subgraphs.messari.tomi"
          },
          {
            "name": "bd.messari.tomi"
          }
        ],
        "subdomainCount": 2
      }
    ]
  }
}
```

### Get an expiration for an Domains domain

```graphql
query getDomainExp($Account: String = "paulieb.tomi") {
  registrations(
    where: { domain_: { name: $Account } }
    first: 1
    orderBy: expiryDate
    orderDirection: desc
  ) {
    expiryDate
  }
}
```

#### Returns

```graphql
{
  "data": {
    "registrations": [
      {
        "expiryDate": "1714752524"
      }
    ]
  }
}
```
