---
title: "Service: /discussions/find [GET]"
source: https://dev.pageseeder.com/api/services/find-discussions-public-GET.html
description: "GET endpoint to find public discussions by filtering comments. Returns paginated list of discussions sorted by most recent activity, with configurable parameters for author, date range, labels, types, and more."
last_updated: 2026-09-02T11:36:00+10:00
document_type: api_endpoint
operation_id: comment-GET
resource_id: comment
path_template: /discussions/find
http_method: GET
api_category: comment
implementation_version: 6.2008
api_since: 5.9400
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~944
---

# /discussions/find \[GET\]

## Description

Find public discussions.

Load a list of discussions using filter parameters. A comment in the discussion must match all filter parameters. The discussions with the most recent last comment are returned first.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| attachments | The attachments to include, can be `none`, `context`, `all` | no | enum | `all` |
| author | The `ID` of the comment author | no | long |  |
| comments | The replies to include, can be `none`, `first`, `last`, `all`, `archive` | no | enum | `last` |
| contents | The contents to include, can be `none`, `all` | no | enum | `all` |
| context | Only return comments in this context, can be `group`, `uri`, `all`. | no | enum | `all` |
| createdafter | The date time after which the comments were created, format is ISO-8601 e.g. `2010-10-25T12:26:00+10:00` | no | datetime |  |
| createdbefore | The date time before which the comments were created, format is ISO-8601 e.g. `2011-08-25T10:20:00-04:00` | no | datetime |  |
| discussionsize | The maximum number of comments to return per discussion (0 = unlimited) | no | integer | `100` |
| emails | The email addresses to include, can be `none`, `all` (admin only) | no | enum | `none` |
| groups | A comma-separated list of group names the comment should belong to (if not specified, the user’s current groups are used) | no | strings |  |
| labels | Comma-separated list of label values – comment **MUST** have all (not recommended for filtering large data sets) | no | strings |  |
| page | The page to load | no | integer | `1` |
| pagesize | The number of results per page | no | integer | `1000` |
| paths | The context URI paths for the comments – **MUST** be URL encoded (comma-separated list with optional `*` suffix) | no | strings |  |
| title | The title of the comments (optional wildcard `*` suffix, use `**` to escape) | no | string |  |
| type | The type of the comments (optional wildcard `*` suffix, use `**` to escape) | no | string |  |
| types | Comma-separated list of types the comment can have (empty string means no type) | no | strings |  |

## Permission

This service requires no permissions but will only work on groups configured for public access and requires `publicEnable=non-member` in the [Global properties](../../guide/configuration/properties/global_properties.md).

If the parameter `emails` is set to `all`, the permission is restricted to administrator only.

## Response

The output has the following format:

```xml

<discussions>
  <discussion id="123" 
              title="My thread"
             [replycount="1"
              lastcommentid="234" 
              lastcommentdate="2012-03-08T12:34:00+10:00"]>
    <uri id="789"> ... </uri>
    <locator fragment="2"/>
    <comment id="234" 
             contentrole="File Attachment" 
             created="2012-08-20T14:27:48+10:00">
      <title>My thread</title>
      <content type="text/plain">Some text</content>
      <attachment>
        <uri id="189"> ... </uri>
      </attachment>
      <attachment fragment="5">
        <uri id="289"> ... </uri>
      </attachment>
    </comment>
  </discussion>
  <discussion id="100">
    ...
  </discussion>
</discussions>
```

> **Note:** The `@replycount` , `@lastcommentid` and `@lastcommentdate` are only included and `@title` is from the last comment, if the `comments` parameter is `last`, `all` or `archive`, otherwise `@title` is from the first comment.

## Error Handling

| 0x1303 | Context 'group' cannot be used with 'paths' parameter |
| --- | --- |
| 0x1306 | The Group is invalid or not accessible |
| 0x1312 | The createdafter or createdbefore date is invalid |
| 0x1313 | The author is invalid |