---
title: "Retrieve one-way synonyms"
method: GET
path: "/v2/one_way_synonyms"
tags: ["Synonyms"]
---

# Retrieve one-way synonyms

`GET /v2/one_way_synonyms`

## Request

- Base URL: `https://ac.cnstrc.com`
- URL: `https://ac.cnstrc.com/v2/one_way_synonyms`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

**🔐 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 all one-way synonyms.

## Query parameters

- `key` string, required: The key of the index to use.
- `parent_phrase` string[]: A list of parent phrases to filter by
- `phrase` string
- `num_results_per_page` integer: The number of results per page to return.
- `page` integer: The page of results to return.
- `offset` integer: The number of results to skip from the beginning. Cannot be used together with `page`.
- `sort_by` 'created_at' | 'updated_at' | 'activated_at'
- `sort_order` 'ascending' | 'descending'
- `c` string: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Response `200`

OK

- OneWaySynonymV2ListGetResponse
  - `one_way_synonym_relations` OneWaySynonymRelationV2[], required: A list of one way synonyms
    - `parent_phrase` string, required
    - `child_phrases` PhraseResponse[], required
      - `phrase` string, required
      - `automatically_generated` boolean
      - `created_at` string, date-time: One way synonym creation date and time in ISO 8601 format
      - `updated_at` string, date-time: Last one way synonym update date and time in ISO 8601 format.
      - `activated_at` string, date-time: Last one way synonym update date and time in ISO 8601 format.
  - `total_count` integer, required: Total count of one way synonyms returned

## Other responses

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

---

[API](https://skmtc.dev/constructor/apis/configuration.md) - [All operations](https://skmtc.dev/constructor/apis/configuration/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/configuration/revisions/205ffdb5f494?raw)