, // If FetchYouDiamonded is true, this will be the profile of the receiver. If false, this will be the profile of the sender.
},
],
TotalDiamonds: 555 // Total number of diamonds received or given by the profile that matches PublicKeyBase58Check
}
```
{% endtab %}
{% tab title="Response Field Descriptions" %}
...coming soon! See comments in sample response for descriptions for now.
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
## Get Follows Stateless
`POST` `/api/v0/get-follows-stateless`
Get followers of a certain user/public key or get users followed by a certain user/public key and the total number of followers/followees.
Endpoint implementation in backend.
Example usages in frontend:\
\- Make request to [Get Follows Stateless](https://github.com/deso-protocol/frontend/blob/e006beb72867f6d48a78adb1d126c66144a4298c/src/app/backend-api.service.ts#L1274)\
\- Use GetFollows to show [the total number of users following a creator and the total number of users followed by a creator](https://github.com/deso-protocol/frontend/blob/e006beb72867f6d48a78adb1d126c66144a4298c/src/app/creator-profile-page/creator-profile-top-card/creator-profile-top-card.component.ts#L161)\
\- Use GetFollows to [see all users who follow (or alternatively are followed by) a creator](https://github.com/deso-protocol/frontend/blob/e006beb72867f6d48a78adb1d126c66144a4298c/src/app/manage-follows-page/manage-follows/manage-follows.component.ts#L54)
#### Request Body
| Name | Type | Description |
| --------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| PublicKeyBase58Check | String | Public key for which we want to fetch followers or followees
Required only if Username is not provided
|
| Username | String | Username for which we want to fetch followers or following
Required only if PublicKeyBase58Check is not provided
|
| GetEntriesFollowingUsername | Boolean | - If true, get entries that are following the specified user.
- If false, get entries that are followed by the specified user.
|
| LastPublicKeyBase58Check | String | Public key of the last follower/followee from the previous page. Indicates the point at which we want to start returning results. |
| NumToFetch | uint64 | number of records to fetch |
{% tabs %}
{% tab title="200: OK Successfully retrieved the requested page of followers/followee" %}
{% tabs %}
{% tab title="Sample Response" %}
```json5
{
PublicKeyToProfileEntry: { // Map of public key to ProfileEntryResponse representing followers or followees
"BC1YLfuD5AGm2guj3q5wF7WGi3jTUzNhHUHc84GtVsk9kHyxbnk5V1H" :
},
NumFollowers: 17707 // Total number of followers or followees
}
```
{% endtab %}
{% tab title="Response Field Descriptions" %}
...coming soon! See comments in sample response for descriptions for now.
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
## Is Following Public Key
`POST` `/api/v0/is-following-public-key`
Check if the user is following a public key.
Endpoint implementation in [backend](https://github.com/deso-protocol/backend/blob/709cbfbc62cf3a0e6d56c393e555fc277c93fb76/routes/user.go#L2669).
#### Request Body
| Name | Type | Description |
| ----------------------------------------------------------------- | ------ | ------------------------------------------------------------------- |
| PublicKeyBase58Check\* | String | Public key of the user that may be following |
| IsFollowingPublicKeyBase58Check\* | String | Public key of the creator we want to check if the user is following |
{% tabs %}
{% tab title="200: OK Successfully retrieved whether or not the request public key is following IsFollowingPublicKeyBase58Check" %}
{% tabs %}
{% tab title="Sample Response" %}
```json5
{
IsFollowing: true // true if the user is following the IsFollowingPublicKeyBase58Check. Otherwise, false.
}
```
{% endtab %}
{% tab title="Response Field Descriptions" %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}
## Is Hodling Public Key
`POST` `/api/v0/is-hodling-public-key`
Check if the user holds the creator coin of a public key. If user is holding some amount of creator coin, we return the BalanceEntryResponse representing how much the user holds.
Endpoint implementation in [backend](https://github.com/deso-protocol/backend/blob/036804dc7c182305ceb8172cbb92598dcbd4d102/routes/user.go#L2836).
Example usages in frontend:\
\- Make request to [Is Hodling Public Key](https://github.com/deso-protocol/frontend/blob/60cf5571269c01b13da618e214d35d7f2b5614f1/src/app/backend-api.service.ts#L1387)\
\- Use IsHodlingPublicKey to [check if a user is a DAO member and can be transferred a DAO coin that is restricted to DAO members only.](https://github.com/deso-protocol/frontend/blob/60cf5571269c01b13da618e214d35d7f2b5614f1/src/app/dao-coins/transfer-dao-coin-modal/transfer-dao-coin-modal.component.ts#L53)
#### Request Body
| Name | Type | Description |
| --------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------- |
| PublicKeyBase58Check\* | String | Public key of the user that may be holding the creator coin of IsHodlingPublicKeyBase58Check |
| IsHodlingPublicKeyBase58Check\* | String | Public key of the creator we want to check that the user is holding |
| IsDAOCoin | Boolean | If true, check if this public key is hodling the DAO coin instead of creator coin |
{% tabs %}
{% tab title="200: OK Successfully retrieved whether PublicKeyBas58Check is hodling the creator coin or DAO coin of IsHodlingPublicKeyBase58Check" %}
{% tabs %}
{% tab title="Sample Response" %}
```json5
{
IsHodling: true, // true if the user holds the creator coin of IsHodlingPublicKeyBase58Check, Otherwise, false.
BalanceEntry: // Balance entry that shows the amount of creator coins the user holds.
}
```
{% endtab %}
{% tab title="Response Field Descriptions" %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% tab title="400: Bad Request " %}
```javascript
{
// Response
}
```
{% endtab %}
{% endtabs %}