---
title: "Service: /groups/{group}/facet [GET]"
source: https://dev.pageseeder.com/api/services/get-group-facet-GET.html
description: "Returns facet data for a specified index field within a group, displaying term occurrences and cardinality. Restricted to guest and higher permissions."
last_updated: 2026-09-02T11:36:04+10:00
document_type: api_endpoint
operation_id: search-GET
resource_id: search
path_template: /groups/{group}/facet
http_method: GET
api_category: search
implementation_version: 6.2004
api_since: 4.9023
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: max-age=30, must-revalidate
generated_at: 2026-09-02
tokens: ~216
---

# /groups/\{group\}/facet \[GET\]

## Description

Returns the facets for a specific field in the [index](../../reference/glossary/index_xml.md).

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| field | A valid index field | yes | string |  |

See [Index](../../reference/index.md) for index fields available.

## Permission

This service is restricted to guest and higher.

## Response

When the field is valid, the XML returned is:

```xml

<facet name="[field name]" type="field" computed="true" total="[total]">
  <term field="[field name]" text="[term]" cardinality="[occurrences]"/>
  ...
</facet>
```

If field is invalid, return:

```xml

<facet name="pd" type="field" computed="true" total="0"/>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x0201 | Missing required field |