---
description: >-
  Base Name Service provides a free REST API for developers to integrate .base
  names.
---

# BNS API

## Resolve .base name to address <a href="#domain-resolution" id="domain-resolution"></a>

<mark style="color:blue;">`GET`</mark> `https://resolver-api.basename.app/v1/names/{name}`

#### Example request

```
https://resolver-api.basename.app/v1/names/hello.base
```

#### Example response

```json
{
  "statusCode": 200,
  "name": "hello.base",
  "address": "0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC"
}
```

## Resolve address to .base name <a href="#domain-resolution" id="domain-resolution"></a>

<mark style="color:blue;">`GET`</mark> `https://resolver-api.basename.app/v1/addresses/{address}`

#### Example request

```
https://resolver-api.basename.app/v1/addresses/0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC
```

#### Example response

```json
{
  "statusCode": 200,
  "name": "hello.base",
  "address": "0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC"
}
```
