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

# Owners

### Distribution <a href="#distribution" id="distribution"></a>

This endpoint can be used to retrieve the domains distribution (includes escrow wallets)

```
GET /owners/distribution
```

> Response

```json
{
  "success": true,
  "result": [
    { "nb_owners": 1, "nb_domains": 41896 }
    // ...
  ]
}
```

This endpoint can be used to retrieve the domains distribution (excludes escrow wallets)

```
GET /owners/distribution-exclude-escrows
```

> Response

```json
{
  "success": true,
  "result": [
    { "nb_owners": 1, "nb_domains": 41896 }
    // ...
  ]
}
```

### Domains For Owner <a href="#domains-for-owner" id="domains-for-owner"></a>

This endpoint can be used to retrieve the domain owned by a public key

```
GET /owners/{owner_key}/domains
```

> Response

```json
{
  "success": true,
  "result": [
    "pharmacy",
    "softball",
    "travelagent"
    // ...
  ]
}
```