> ## Documentation Index
> Fetch the complete documentation index at: https://thehyperstack.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Groups

### Description

This endpoint allows you to **list all credential groups** or filter them based on title and pagination.

### Headers

<ParamField header="Authorization" type="string" required="true">
  Bearer YOUR\_API\_TOKEN — obtainable from **Hyperstack Dashboard → Settings → API Access**
</ParamField>

### Body Parameters

<ParamField body="keyword" type="string" required="false">
  Search keyword matched against group titles. Takes precedence over `title` if both are provided. Partial word matches are supported unless `strict` is enabled.
</ParamField>

<ParamField body="title" type="string" required="false">
  Alias for `keyword`. Filter groups by title.
</ParamField>

<ParamField body="strict" type="boolean" required="false">
  When `true`, the entire keyword must appear as a contiguous phrase in the title. When `false` (default), any word in the keyword can match independently.
</ParamField>

<ParamField body="page" type="number" required="false">
  The page number for pagination (default is 1).
</ParamField>

<ParamField body="page_size" type="number" required="false">
  The number of groups to return per page (default is 50).
</ParamField>

### Success Response Fields

<ResponseField name="success" type="boolean">
  Indicates whether the group search was successful.
</ResponseField>

<ResponseField name="groups" type="array[object]">
  An array of credential group objects matching the search criteria.
</ResponseField>

<ResponseField name="page" type="number">
  Current page number in the results.
</ResponseField>

<ResponseField name="page_size" type="number">
  Number of groups returned per page.
</ResponseField>

<ResponseField name="total" type="number">
  Total number of groups matching the search.
</ResponseField>

### Responses

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "success": true,
    "total": 2,
    "page": 1,
    "page_size": 50,
    "groups": [
      {
        "title": "Certificate of Security Course Completion",
        "group_key": "Zvw1xPIqF7J7",
        "group_code": "SCC-2023",
        "last_modified": "2023-08-21T08:25:25.930Z",
        "created_at": "2022-08-07T14:09:43.311Z"
      },
      {
        "title": "Certificate of Cloud Management",
        "group_key": "l2DdnE614Fs2",
        "group_code": "CM-1",
        "last_modified": "2023-08-21T08:25:25.930Z",
        "created_at": "2022-08-07T14:09:43.311Z"
      }
    ]
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "detail": "Invalid token or organization not found"
  }
  ```
</ResponseExample>