---
title: "Retrieve words that are similar"
method: GET
path: "/entries/{source_lang}/{word_id}/synonyms"
tags: ["Thesaurus"]
---

# Retrieve words that are similar

`GET /entries/{source_lang}/{word_id}/synonyms`

## Request

- Base URL: `https://od-api-demo.oxforddictionaries.com:443/api/v1`
- URL: `https://od-api-demo.oxforddictionaries.com:443/api/v1/entries/{source_lang}/{word_id}/synonyms`
- Auth: none declared. Required headers: `app_id`, `app_key`

Use this to retrieve words that are similar in meaning to the input word ([synonym](documentation/glossary?term=synonym)).

  <div id="synonyms"></div>

## Path parameters

- `source_lang` 'en', required
- `word_id` string, required

## Headers

- `app_id` string, required
- `app_key` string, required

## Response `200`

Successful response.

- Thesaurus: Schema for thesaurus endpoint
  - `metadata` object: Additional Information provided by OUP
  - `results` HeadwordThesaurus[]: A list of found synonyms or antonyms
    - `id` string, required: The identifier of a word
    - `language` string, required: IANA language code
    - `lexicalEntries` ThesaurusLexicalEntry[], required: A grouping of various senses in a specific language, and a lexical category that relates to a word
      - `entries` ThesaurusEntry[]
        - `homographNumber` string: Identifies the homograph grouping. The last two digits identify different entries of the same homograph. The first one/two digits identify the homograph number.
        - `senses` ThesaurusSense[]: Complete list of senses
          - `antonyms` object[]
            - `domains` string[]
            - `id` string, required
            - `language` string
            - `regions` string[]
            - `registers` string[]
            - `text` string, required
          - `domains` string[]
          - `examples` object[]: A list of written or spoken rendering of examples of use of a word or text
            - `definitions` string[]
            - `domains` string[]
            - `notes` object[]: various types of notes that appear
              - …
            - `regions` string[]
            - `registers` string[]
            - `senseIds` string[]
            - `text` string, required
            - `translations` object[]: A list of written or spoken rendering of the meaning of a word or text in another language(s)
              - …
          - `id` string: The id of the sense that is required for the delete procedure
          - `regions` string[]
          - `registers` string[]
          - `subsenses` ThesaurusSense[]: subsenses of word
          - `synonyms` object[]
            - `domains` string[]
            - `id` string, required
            - `language` string
            - `regions` string[]
            - `registers` string[]
            - `text` string, required
        - `variantForms` object[]: Various words that are used interchangeably depending on the context, e.g 'aluminium' and 'aluminum'
          - `regions` string[]
          - `text` string, required
      - `language` string, required: IANA language code
      - `lexicalCategory` string, required: A linguistic category of words (or more precisely lexical items), generally defined by the syntactic or morphological behaviour of the lexical item in question, such as noun or verb
      - `text` string, required: A given written or spoken realisation of a an entry.
      - `variantForms` object[]: Various words that are used interchangeably depending on the context, e.g 'aluminium' and 'aluminum'
        - `regions` string[]
        - `text` string, required
    - `type` string: The json object type. Could be 'headword', 'inflection' or 'phrase'
    - `word` string, required: A given written or spoken realisation of a an entry, lowercased.

## Other responses

- `404`: No entry is found matching supplied id and source_lang or filters are not recognized
- `500`: Internal Error. An error occurred while processing the data.

---

[API](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api.md) - [All operations](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oxforddictionaries/apis/oxforddictionaries-guest-api/revisions/6acbf89f6aeb?raw)