---
title: "Get a group"
method: GET
path: "/v1/groups/{id}"
tags: ["Groups"]
---

# Get a group

`GET /v1/groups/{id}`

## Request

- Base URL: `https://api.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/groups/{id}`
- Auth: HTTP bearer

Returns one keyword group with its external id and keyword counts.

## Path parameters

- `id` string, required: The group's id (grp_...).

## Response `200`

The requested group

- Group: The keyword's group.
  - `id` string, required: The group's id (grp_...).
  - `name` string, required: Name of the group.
  - `externalId` string, nullable, required: An id from your own system, or null.
  - `isDefault` boolean, required: True for the workspace's default group. New keywords go there when you don't name a group.
  - `context` string, nullable, required: A company description just for this group, which the classifier reads. Null means the workspace profile is used.
  - `stats` object, required: Counted from the group's keywords.
    - `keywords` integer, required: Number of keywords in the group, muted or not.
    - `active` integer, required: Number of unmuted keywords in the group.
  - `createdAt` string, required: UTC time in ISO 8601.
  - `updatedAt` string, required: UTC time in ISO 8601.

## Other responses

- `401`: The API key is missing or not valid
- `404`: This workspace has no group with this id

---

[API](https://skmtc.dev/rumoro/apis/rumoro-api.md) · [All operations](https://skmtc.dev/rumoro/apis/rumoro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rumoro/apis/rumoro-api/revisions/9ef63ea894d1?raw)