This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
« Create or update synonyms set List synonyms sets »
Elastic Docs ›Elasticsearch Guide [master] ›REST APIs ›Synonyms APIs

Get synonyms set

edit

Get synonyms set

edit

Retrieves a synonyms set.

Request

edit

GET _synonyms/<synonyms_set>

Prerequisites

edit

Requires the manage_search_synonyms cluster privilege.

Path parameters

edit
<synonyms_set>
(Required, string) Synonyms set identifier to retrieve.

Query parameters

edit
from
(Optional, integer) Starting offset for synonyms rules to retrieve. Defaults to 0.
size
(Optional, integer) Specifies the maximum number of synonyms rules to retrieve. Defaults to 10.

Response codes

edit
400
The synonyms_set identifier was not provided.
404 (Missing resources)
No synonyms set with the identifier synonyms_set was found.

Examples

edit

The following example retrieves a synonyms set called my-synonyms-set:

resp = client.synonyms.get_synonym(
    id="my-synonyms-set",
)
print(resp)
response = client.synonyms.get_synonym(
  id: 'my-synonyms-set'
)
puts response
const response = await client.synonyms.getSynonym({
  id: "my-synonyms-set",
});
console.log(response);
GET _synonyms/my-synonyms-set

The synonyms set information returned will include the total number of synonyms rules that the synonyms set contains, and the synonyms rules according to the from and size parameters.

A sample response:

{
  "count": 3,
  "synonyms_set": [
    {
      "id": "test-1",
      "synonyms": "hello, hi"
    },
    {
      "id": "test-2",
      "synonyms": "bye, goodbye"
    },
    {
      "id": "test-3",
      "synonyms": "test => check"
    }
  ]
}
« Create or update synonyms set List synonyms sets »