> For the complete documentation index, see [llms.txt](https://rest-api.symphony.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rest-api.symphony.com/main/dlp-dictionary-and-policy-management/dictionary-management-endpoints/specific-dictionary.md).

# Specific Dictionary

## Get dictionary metadata

> Get basic information for a dictionary.

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v1/dlp/dictionaries/{dictId}":{"get":{"tags":["DLP Policies and Dictionary Management"],"summary":"Get dictionary metadata","description":"Get basic information for a dictionary.","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":"dictId","in":"path","description":"Unique dictionary identifier","required":true,"schema":{"type":"string"}},{"name":"dictVersion","in":"query","description":"If set to be valid dictionary version number, will return dictionary metadata with specified version. \nOtherwise, return the latest dictionary metadata.\n","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DLPDictionaryMetadataResponse"}}}},"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":{"V1DLPDictionaryMetadataResponse":{"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DLPDictionaryMetadata"}},"description":"Dictionary response containing 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"}}}}}}
```

> #### 🚧 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.