---
title: "Get the Security Settings object (getSecuritySettings)"
method: GET
path: "/api/admin/securitySettings"
tags: ["admin-controller"]
---

# Get the Security Settings object (getSecuritySettings)

`GET /api/admin/securitySettings`

Get the Security Settings object that contains password policy, etc.

Available for users with 'SYS_ADMIN' authority.

## Response `200`

OK

- SecuritySettings — A JSON value representing the Security Settings.
  - `passwordPolicy` UserPasswordPolicy
    - `minimumLength` integer — Minimum number of symbols in the password.
    - `maximumLength` integer — Maximum number of symbols in the password.
    - `minimumUppercaseLetters` integer — Minimum number of uppercase letters in the password.
    - `minimumLowercaseLetters` integer — Minimum number of lowercase letters in the password.
    - `minimumDigits` integer — Minimum number of digits in the password.
    - `minimumSpecialCharacters` integer — Minimum number of special in the password.
    - `allowWhitespaces` boolean — Allow whitespaces
    - `forceUserToResetPasswordIfNotValid` boolean — Force user to update password if existing one does not pass validation
    - `passwordExpirationPeriodDays` integer — Password expiration period (days). Force expiration of the password.
    - `passwordReuseFrequencyDays` integer — Password reuse frequency (days). Disallow to use the same password for the defined number of days
  - `maxFailedLoginAttempts` integer — Maximum number of failed login attempts allowed before user account is locked.
  - `userLockoutNotificationEmail` string — Email to use for notifications about locked users.
  - `mobileSecretKeyLength` integer — Mobile secret key length
  - `userActivationTokenTtl` integer, required — TTL in hours for user activation link
  - `passwordResetTokenTtl` integer, required — TTL in hours for password reset link

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)