# All Dictionaries

## Get all dictionary metadatas

> Get all dictionary metadatas with the latest version. Each dictionary object will only contain meta data of the content.<br>

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v1/dlp/dictionaries":{"get":{"tags":["DLP Policies and Dictionary Management"],"summary":"Get all dictionary metadatas","description":"Get all dictionary metadatas with the latest version. Each dictionary object will only contain meta data of the content.\n","parameters":[{"name":"sessionToken","in":"header","description":"Session authentication token.","required":true,"schema":{"type":"string"}},{"name":"keyManagerToken","in":"header","description":"Key Manager authentication token.","schema":{"type":"string"}},{"name":"page","in":"query","description":"Optional parameter to specify which page to return (default is 0)","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"Optional parameter to specify the number of result to return per page, default is 50. Maximum is 50.\n","schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DLPDictionaryMetadataCollectionResponse"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"V1DLPDictionaryMetadataCollectionResponse":{"type":"object","required":["items"],"properties":{"items":{"type":"array","description":"List of dictionary metadata","items":{"$ref":"#/components/schemas/V1DLPDictionaryMetadata"}},"page":{"type":"integer","description":"Page number of current page","format":"int32"},"pageCount":{"type":"integer","description":"Total number of pages available","format":"int32"}},"description":"List of dictionary metadata."},"V1DLPDictionaryMetadata":{"required":["dictRef","type"],"type":"object","properties":{"creationDate":{"type":"integer","description":"Creation time of the dictionary in milliseconds elapsed as of epoch time.","format":"int64"},"creatorId":{"type":"string","description":"Numeric userId of the creator"},"dictRef":{"$ref":"#/components/schemas/V1DLPDictionaryRef"},"lastUpdatedDate":{"type":"integer","description":"The recent update time of the dictionary in milliseconds","format":"int64"},"type":{"type":"string","description":"The type of dictionary, which specify the content is a list of words or a list of regexes.\nBy default set to \"Word\" if not specified. Possible values - Word, Regex\n"}},"description":"Dictionary's metadata (excluding content)"},"V1DLPDictionaryRef":{"required":["name"],"type":"object","properties":{"dictId":{"type":"string","description":"Unique dictionary id"},"name":{"type":"string","description":"Unique name of a dictionary, max 30 characters, with trimmed leading and trailing blank spaces."},"version":{"type":"string","description":"The version of a dictionary, in format \"major.minor\".\nInitial value will set by backend as \"1.0\" when created.\nWhenever the dictionary version needs to be changed, the minor version by 1 unless minor == 999, then the major version is increased by 1 until it reaches 999.\n"}},"description":"Basic information needed to identify a dictionary"},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

Results do not include dictionary content or [deleted dictionaries](/main/dlp-dictionary-and-policy-management/dictionary-management-endpoints/delete-dictionary.md).

> #### 🚧 Required Permissions
>
> Calling this endpoint requires a Service User Account set with the Expression Filter Policy Management role. For more information about Service User accounts and their roles, see the [Symphony Administration Guide](https://symphony.direct/).
>
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rest-api.symphony.com/main/dlp-dictionary-and-policy-management/dictionary-management-endpoints/all-dictionaries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.