> For the complete documentation index, see [llms.txt](https://relationlabs.gitbook.io/relation-graph/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://relationlabs.gitbook.io/relation-graph/api/sbt-list.md).

# SBT List

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

* Through this API, you will be able to query the SBTs list held by the user
* Header

| Field  | Type   | Required | Remarks                                                                   |
| ------ | ------ | -------- | ------------------------------------------------------------------------- |
| ApiKey | String | true     | [ApiKey](/relation-graph/api/sbt-list.md) obtained from the administrator |

* Request Parameters

| Field           | Type   | Required | Remarks          |
| --------------- | ------ | -------- | ---------------- |
| address         | String | fasle    | EOA Address      |
| twitterUsername | String | fasle    | twitter username |
| steamId         | String | fasle    | steamId          |

* Request Example

```shell
curl  GET 'https://api.relationlabs.ai/api/v1/sbt/list?address=0x9bd286ef4e3d9ec1af6c6ae9da2f0b3617deab13' \
--header 'ApiKey: <ApiKey>'
```

* Response Parameters

| Field | Type   | Remarks         |
| ----- | ------ | --------------- |
| code  | String | Return code     |
| desc  | String | Return message  |
| data  | List   | User's SBT list |

The SBT field consists of the following subfields:

| Field           | Type   | Remarks                 |
| --------------- | ------ | ----------------------- |
| contractAddress | String | SBT contract address    |
| sbtName         | String | SBT Name                |
| tokenId         | String | tokenId                 |
| rdfData         | String | Semantic statement      |
| imageUrl        | String | The image url of SBT    |
| metadataUrl     | String | The metadata url of SBT |

* Response Body

```json
{
  "code": "0",
  "desc": "success",
  "data": [
    {
      "contractAddress": "0x1dcc0fbb80d2c6a62ee35835e03c98924d413153",
      "sbtName": "Relation Medal Not Alone",
      "tokenId": "32945",
      "imageUrl": "https://3fypb-gqaaa-aaaag-aaedq-cai.ic1.io/icon/medal/medal_5.png",
      "rdfData": ":Soul_0x9c880a0df075b2a2dc5ec9b5aeb2f0215963f14b p:achieved :relation-medal_not-alone-level1.",
      "metadataUrl": "https://z.com/aa.json"
    }
  ]
}
```

* Return Code

| code  | desc    | Remarks                                   |
| ----- | ------- | ----------------------------------------- |
| 0     | success | the flag for a successful request         |
| 11601 | failed  | this field not support in current version |
| 11602 | failed  | user not found                            |