---
title: "Retrieve synonym group"
method: GET
path: "/v1/synonym_groups/{group_id}"
tags: ["Synonym groups"]
---

# Retrieve synonym group

`GET /v1/synonym_groups/{group_id}`

**🔐 This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).**
For authenticating with Bearer token, required scopes are: `synonyms(r)`.

Retrieve synonym group by identifier.

## Path parameters

- `group_id` integer, required

## Query parameters

- `key` string, required — The key of the index to use.
- `section` string — The section of the index to use. Defaults to `Products`.
- `c` string — The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Response `200`

OK

- SynonymGetResponse
  - `total_count` integer, required
  - `synonym_groups` SynonymGroupGetResponse[], required
    - `synonyms` string[], required
    - `synonym_group_id` integer, required — The ID of the synonym group, must be unique.
    - `created_at` string, date-time, required — Synonym group creation date in ISO 8601 format
    - `updated_at` string, date-time, required — Last synonym group update date in ISO 8601 format.

## Other responses

- `400` — Validation Error
- `401` — Credentials are not passed or action is forbidden.
- `403` — The supplied token does not have the required permissions.
- `404` — Not Found
- `429` — Rate limit breached

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)