> For the complete documentation index, see [llms.txt](https://developers.ethos.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.ethos.network/api-documentation/api-v1-deprecated/replies.md).

# Replies

## Overview

The Replies API allows querying replies associated with specific contracts and parent IDs, as well as retrieving summaries of reply counts and user participation.

## Endpoints

### Get Reply Summaries

```
POST /api/v1/reply/summary
```

**Description**: Retrieves a summary of replies for specific target contracts and parent IDs, including the total count and whether the current user has participated in the discussion.

**Authentication Required**: No

### Parameters

#### Request Body

| Name                   | Type            | Required | Description                                               |
| ---------------------- | --------------- | -------- | --------------------------------------------------------- |
| `targetContract`       | string          | Yes      | Ethereum address of the target contract                   |
| `parentIds`            | array           | Yes      | Array of parent IDs to fetch reply summaries for          |
| `currentUserProfileId` | integer or null | No       | Profile ID of the current user to check for participation |

### Responses

#### Success Response

**Code**: 200 OK

```json
{
  "ok": true,
  "data": {
    "0x2820b3aB3543ADB80810f11F2651f0DD9A04E801": {
      "1": {
        "count": 0,
        "participated": false
      }
    }
  }
}
```

| Property                                      | Type    | Description                                                         |
| --------------------------------------------- | ------- | ------------------------------------------------------------------- |
| `ok`                                          | boolean | Success status                                                      |
| `data`                                        | object  | Map of target contracts to parent IDs to reply summaries            |
| `data[targetContract]`                        | object  | Map of parent IDs to reply summaries for a specific target contract |
| `data[targetContract][parentId]`              | object  | Reply summary for a specific parent ID                              |
| `data[targetContract][parentId].count`        | integer | Total number of replies                                             |
| `data[targetContract][parentId].participated` | boolean | Whether the current user has participated in the discussion         |

#### Error Response

**Code**: 400 Bad Request

```json
{
  "ok": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation error",
    "fields": [
      {
        "code": "invalid_type",
        "expected": "number",
        "message": "Expected number, received nan",
        "path": ["currentUserProfileId"],
        "received": "nan"
      }
    ]
  }
}
```

### Example

#### Request

```bash
http POST "https://api.ethos.network/api/v1/reply/summary" \
  targetContract=0x2820b3aB3543ADB80810f11F2651f0DD9A04E801 \
  parentIds:='[1]' \
  currentUserProfileId:=null
```

### Notes

* The reply summary endpoint provides an efficient way to get the total number of replies and participation status without fetching all the individual replies.
* The structure of the response allows querying multiple target contracts and parent IDs in a single request.
* When `currentUserProfileId` is `null`, the `participated` field will always be `false`.