> For the complete documentation index, see [llms.txt](https://api-docs.rightsline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.rightsline.com/entities/recipient-group/search-recipient-groups.md).

# Search Recipient Groups

`POST` `https://ris.rightsline.com/v4/recipient-group/search`

**Headers**

| Name           | Type   | Description             |
| -------------- | ------ | ----------------------- |
| x-api-key      | string | Your company's API key. |
| Authentication | string | Authentication token.   |

**Query Parameters**

| Name         | Type    | Description                                                                     |
| ------------ | ------- | ------------------------------------------------------------------------------- |
| extendedData | boolean | When `true`, returns additional field metadata alongside characteristic values. |

**Request Body**

| Name  | Type    | Description                                                                                                          |
| ----- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| query | object  | Search criteria. See [Search fields](https://api-docs.rightsline.com/search/search-fields.md) for available filters. |
| start | integer | Zero-based offset for pagination.                                                                                    |
| rows  | integer | Number of results to return (1–100).                                                                                 |

**Response**

```
{
  "numFound": 1,
  "entities": [
    {
      "id": 1,
      "title": "Recipient Group Title",
      "template": {},
      "status": {},
      "characteristics": {}
    }
  ]
}
```