# 查询地址

## <mark style="color:blue;">GET</mark> /api/v1/listAddress

* 说明： 查询用户的web3地址列表
* Header

| Field         | Type   | Required | Remarks                                                                                        |
| ------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| ApiKey        | String | true     | 从管理员获取的[ApiKey](https://relationlabs.gitbook.io/relation-one-api/api-zh/guide/glossary#apikey) |
| Authorization | String | false    | Bearer ${unifiedAuthToken} ,其中unifiedAuthToken来自/api/v1/auth接口的返回                              |

* Request Parameters

| Field      | Type   | Remarks    |
| ---------- | ------ | ---------- |
| relationId | String | relationId |

* Request Example

```shell
curl  GET 'https://api.relationlabs.ai/api/v1/listAddress?relationId=d4swz-zaaaa-aaaaj-at5fa-cai' \
--header 'ApiKey: <ApiKey>'
```

* Response Parameters

| Field | Type               | Remarks |
| ----- | ------------------ | ------- |
| code  | String             | 返回码     |
| desc  | String             | 返回信息    |
| data  | List\[AddressInfo] | 数据      |

The AddressInfo field consists of the following subfields:

| Field   | Type   | Remarks        |
| ------- | ------ | -------------- |
| address | String | 用户web3 address |

* Response Body

```json
{
  "code": "0",
  "desc": "success",
  "data": [
    {
      "address": "0x9bd286ef4e3d9ec1af6c6ae9da2f0b3617deab13"
    }
  ]
}
```

* Return Code

| code | desc    | Remarks |
| ---- | ------- | ------- |
| 0    | success | 接口调用成功  |