# Comments List

Fetch a paginated list of top-level comments and nested replies for a specific entity (`reference_id` and `reference_type`).

### Query Parameters

- `reference_id` (integer, required): ID of the target resource (e.g. listing ID).
- `reference_type` (string, required): Any string identifier representing the entity scope (e.g. `listings_qa`, `listings_comments`, `updates`, etc.).
- `parent` (integer, optional): Filter by parent comment ID (`0` for root comments). Default: `0`.
- `page` (integer, required): Page number for pagination (starts at `1`).
- `per_page` (integer, optional): Number of records per page (1 to 100). Default: `10`.

> [!NOTE]
> Each comment in the response automatically includes a nested `replies` array containing child replies and `liked`/`unliked` flags tailored to the authenticated requesting user.
