# User Tag

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

* Through this API, you will be able to query the tag data authorized by users. Different types of projects or organizations issue SBTs through the [Relation Protocol](https://docs.relationlabs.ai/), which are held by various users. This also indicates that users have participated in related projects or activities and have on-chain relationships with different types of projects or organizations. We will tag users based on the type of project or organization, such as: Game-Fi, De-Fi, etc. This data needs to be [decrypted using the Lit Protocol](https://relationlabs.gitbook.io/graph-zh/guide/use-litprotocol-to-decrypt).
* Header

| Field  | Type   | Required | Remarks                                                                                               |
| ------ | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| ApiKey | String | true     | [ApiKey](https://relationlabs.gitbook.io/relation-graph/api/user-tag) obtained from the administrator |

* Request Parameters

| Field           | Type   | Required | Remarks                                                                                                                                                                                                                        |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| address         | String | fasle    | EOA Address                                                                                                                                                                                                                    |
| twitterUsername | String | fasle    | twitter username                                                                                                                                                                                                               |
| steamId         | String | fasle    | steamId                                                                                                                                                                                                                        |
| sig             | String | true     | User authorization information (when provided with authorization details, developers can [use Lit Protocol to decrypt](https://relationlabs.gitbook.io/relation-graph/guide/use-litprotocol-to-decrypt) the returned results). |
| message         | String | true     | Original text of user authorization information signature （Please refer to the original signature splicing[SIWE](https://docs.login.xyz/).The statement field needs to be:**Access to User Tag.**)）                            |

* Request Example

```shell
curl  GET 'https://api.relationlabs.ai/api/v1/tag?address=0x9bd286ef4e3d9ec1af6c6ae9da2f0b3617deab13&sig=0x0011111&message=example.com%20wants%20you%20to%20sign%20in%20with...' \
--header 'ApiKey: <ApiKey>'
```

* Response Parameters

| Field | Type          | Remarks                                                                       |
| ----- | ------------- | ----------------------------------------------------------------------------- |
| code  | String        | Return code                                                                   |
| desc  | String        | Return message                                                                |
| data  | EncryptedData | Tag data encrypted using Lit Protocol; decryption requires user authorization |

Data structure after decrypting EncryptedData

```json
[
  "DAO",
  "Defi",
  "game"
]
```

* Response Body

```json
{
  "code": "0",
  "desc": "success",
  "data": {
    "encryptedString": "xxx",
    "encryptedSymmetricKey": "xxx"
  }
}
```

* Return Code

| code | desc    | Remarks                           |
| ---- | ------- | --------------------------------- |
| 0    | success | the flag for a successful request |