---
title: "List groups"
description: "The keyword groups of the workspace, the default group first, then oldest first. A group is how keywords are grouped (a customer, a campaign, a product): a term may be tracked once per group, every keyword belongs to one, and GET /v1/usage/breakdown?by=group says what each group cost. Pass `externalId` to find the group carrying your own id."
canonical: https://docs.mentio.dev/api/groups/list-groups
markdown: https://docs.mentio.dev/api/groups/list-groups.mdx
---

# List groups

`GET /v1/groups`

The keyword groups of the workspace, the default group first, then oldest first. A group is how keywords are grouped (a customer, a campaign, a product): a term may be tracked once per group, every keyword belongs to one, and GET /v1/usage/breakdown?by=group says what each group cost. Pass `externalId` to find the group carrying your own id.

## Parameters

- `externalId` (query): Only the group carrying exactly this externalId.

## Responses

- 200: The groups
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx