, // 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 %}
| Name | Type | Description |
| ----------- | ------- | ----------------------------------------------------------------------------------- |
| IsFollowing | Boolean | true if the user is following the IsFollowingPublicKeyBase58Check. Otherwise, false |
## 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 %}
| Name | Type | Description |
| ------------ | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| IsHodling | Boolean | true if the user holds the creator coin of IsHodlingPublicKeyBase58Check, Otherwise, false. |
| BalanceEntry | [Broken mention](broken://pages/EUC9yq2qBWPTvVaptiST#balanceentryresponse) | [Broken mention](broken://pages/EUC9yq2qBWPTvVaptiST#balanceentryresponse) that shows the amount of creator coins the user holds. |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.deso.org/deso-backend/api/social-endpoints.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.