AWS Identity and Access Management
Archived: 2026-04-05 21:13:28 UTC
Retrieves the password policy for the AWS account. This tells you the complexity requirements and mandatory
rotation periods for the IAM user passwords in your account. For more information about using a password policy,
see Managing an IAM password policy.
Response Elements
The following element is returned by the service.
PasswordPolicy
A structure that contains details about the account's password policy.
Type: PasswordPolicy object
Errors
For information about the errors that are common to all actions, see Common Error Types.
NoSuchEntity
The request was rejected because it referenced a resource entity that does not exist. The error message
describes the resource.
HTTP Status Code: 404
ServiceFailure
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500
Examples
Example
This example illustrates one usage of GetAccountPasswordPolicy.
Sample Request
https://iam.amazonaws.com/?Action=GetAccountPasswordPolicy
&Version=2010-05-08
https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountPasswordPolicy.html
Page 1 of 3

&AUTHPARAMS
Sample Response
<GetAccountPasswordPolicyResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
 <GetAccountPasswordPolicyResult>
 <PasswordPolicy>
 <AllowUsersToChangePassword>true</AllowUsersToChangePassword>
 <RequireUppercaseCharacters>true</RequireUppercaseCharacters>
 <RequireSymbols>true</RequireSymbols>
 <ExpirePasswords>false</ExpirePasswords>
 <PasswordReusePrevention>12</PasswordReusePrevention>
 <RequireLowercaseCharacters>true</RequireLowercaseCharacters>
 <MaxPasswordAge>90</MaxPasswordAge>
 <HardExpiry>false</HardExpiry>
 <RequireNumbers>true</RequireNumbers>
 <MinimumPasswordLength>12</MinimumPasswordLength>
 </PasswordPolicy>
 </GetAccountPasswordPolicyResult>
 <ResponseMetadata>
 <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
 </ResponseMetadata>
</GetAccountPasswordPolicyResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
AWS Command Line Interface V2
AWS SDK for .NET V4
AWS SDK for C++
AWS SDK for Go v2
AWS SDK for Java V2
AWS SDK for JavaScript V3
AWS SDK for Kotlin
AWS SDK for PHP V3
AWS SDK for Python
AWS SDK for Ruby V3
https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountPasswordPolicy.html
Page 2 of 3

Source: https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountPasswordPolicy.html
https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountPasswordPolicy.html
Page 3 of 3