> For the complete documentation index, see [llms.txt](https://relationlabs.gitbook.io/relation-one-api/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-one-api/api/follows/following.md).

# Following

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

* Note: It is for querying the list of people whom a particular user follows.
* Header

| Field         | Type   | Remarks                                                                                           |
| ------------- | ------ | ------------------------------------------------------------------------------------------------- |
| ApiKey        | String | [ApiKey](/relation-one-api/guide/glossary.md#apikey) acquired from the admin                      |
| Authorization | String | Bearer ${unifiedAuthToken} , in which the unifiedAuthToken is the result returned by /api/v1/auth |

* Request Parameters

| Field   | Type   | Remarks                                                                                            |
| ------- | ------ | -------------------------------------------------------------------------------------------------- |
| address | String | relationId or address                                                                              |
| limit   | int    | Query limit (up to 100)                                                                            |
| cursor  | string | Cursor data returned by last page. If it is empty, it means the caller is querying the first page. |

* Request Example

```shell
curl  GET 'https://api.relationlabs.ai/api/v1/following?address=dhkyq-sqaaa-aaaaj-sgz3q-cai&cursor=a27d353aa6c84ad38e0ec98cf1b4b73f&limit=4' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: Bearer eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiJiOTE5N1Y1OGJmYTY0NDRlYmU2ODA1OTc2MmViNzdlZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2MDgyNDM0MSwic3ViIjoiYmFmMzQta2lhYWEtYWFhYWstYWNnamEtY2FpIiwiZXhwIjoxNjYxNDI5MTQxfQ.Y_1NR0N3NgQCzaR1owS6Ga4AbOIfvH7ucZJJ9-HUK_FrXBtG_WjTa3XNDfmHZIwCFDOzAjSHNcRdDaR0NZGUIw'
```

* Response Parameters

| Field | Type              | Remarks            |
| ----- | ----------------- | ------------------ |
| code  | String            | the Return Code    |
| desc  | String            | the Return Message |
| data  | FollowingResponse | the Data           |

The FollowingResponse field consists of the following subfields:

| Field  | Type             | Remarks           |
| ------ | ---------------- | ----------------- |
| cursor | String           | the cursor        |
| list   | List\[Following] | list of followers |

The Following field consists of the following subfields:

| Field      | Type   | Remarks           |
| ---------- | ------ | ----------------- |
| relationId | String | User's relationId |
| name       | String | User name         |
| avatar     | String | User's avatar     |

* Response Body

```json
{
    "code": "0",
    "desc": "success",
    "data": {
        "cursor": "987a6dc3e3a34c759f3a3607f002d69d",
        "list": [
            {
                "relationId": "1pvde-wiaaa-aaaaj-abihq-cai",
                "name": "test_user",
                "avatar": "https://3fypb-gqaaa-aaaag-aaedq-cai.ic1.io/avatar/17b46f1160e14e1d91e32d3b59d8d6aa"
            }
        ]
    }
}

```

* Return Code

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