---
title: "List groups"
description: "Returns the workspace's keyword groups, the default group first and then the oldest. Groups organize keywords, for example by client, campaign or product. Every keyword is in one group, a group can hold a term once, and GET /v1/usage/breakdown?by=group shows each group's cost. `externalId` looks a group up by your own id."
canonical: https://docs.rumoro.dev/api/groups/list-groups
markdown: https://docs.rumoro.dev/api/groups/list-groups.mdx
---

# List groups

`GET /v1/groups`

Returns the workspace's keyword groups, the default group first and then the oldest. Groups organize keywords, for example by client, campaign or product. Every keyword is in one group, a group can hold a term once, and GET /v1/usage/breakdown?by=group shows each group's cost. `externalId` looks a group up by your own id.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `externalId` | query | Filters to the one group whose externalId matches exactly. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The workspace's groups |
| 401 | The API key is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).