# List Password policies

> Source: https://truto.one/docs/api-reference/unified-cloud-infrastructure-api/passwordpolicies/list/

`GET /unified/cloud-infrastructure/password_policies`

Resource: **PasswordPolicies** · API: **Unified Cloud Infrastructure API**

## Supported integrations

Amazon Web Services

## Query parameters

- **`integrated_account_id`** _(string, required)_
  The ID of the integrated account to use for the request.
- **`truto_response_format`** _(string)_
  The format of the response. - `unified` returns the response with unified mappings applied. - `raw` returns the unprocessed, raw response from the remote API. - `normalized` applies the unified mappings and returns the data in a normalized format. - `stream` returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory. - `debug` returns the final unified result alongside raw remote fetch information. The response is an envelope containing `result` (identical to unified mode output) and `debug` (with `requestUrl`, `requestOptions`, `data`, `responseHeaders`, and for list operations: `nextCursor`, `isLooping`, `isEmptyResult`, `resultCount`). When the upstream body exceeds 1 MiB, `data` is replaced by `{ truto_truncated: true, truto_max_bytes, truto_excerpt }`. `debug` is `null` for static responses or when `truto_skip_api_call=true`. Defaults to `unified`.
  Allowed: `unified`, `raw`, `normalized`, `stream`, `debug`
- **`truto_key_by`** _(string)_
  By default the `result` attribute is an array of objects. This parameter allows you to specify a field in each `result` objects to use as key, which transforms the `result` array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
- **`truto_ignore_limit`** _(boolean)_
  Ignores the `limit` query parameter.
- **`truto_ignore_remote_data`** _(boolean)_
  Excludes the `remote_data` attribute from the response.
- **`truto_exclude_fields`** _(array<string>)_
  Array of fields to exclude from the response.
- **`remote_query`** _(object)_
  Query parameters to pass to the underlying API without any transformations. Refer [this guide](https://truto.one/docs/api-reference/overview/querying#remote-query-parameters) to see how to structure the query parameters.

## Response body

- **`result`** _(array<object>)_
  List of Password policies
  - **`id`** _(string, required)_
    Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.
  - **`provider_id`** _(string)_
    The provider's own identifier, verbatim -- a full ARN, resource id, or self-link. Never truncated or normalised. Use it to find the object in the provider's console.
  - **`provider`** _(string)_
    Which cloud this object was read from.
    Allowed: `aws`, `azure`, `gcp`
  - **`account`** _(string)_
    The account, subscription or project this object belongs to.
  - **`region`** _(string)_
    Where the object is located. 'global' marks resources with no region (e.g. IAM, a GCP VPC network). If the provider gives none, the collector's queried region is used instead and flagged in unreadable_fields.
  - **`native_type`** _(string)_
    The provider's own type string, unmodified -- for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.
  - **`tags`** _(object)_
    Key-value pairs exactly as the customer set them -- no case folding, key/value normalisation, or merging across providers. An empty object means no tags; unreadable tags appear in unreadable_fields instead.
  - **`collected_at`** _(string)_
    When Truto read this object from the provider, in UTC ISO 8601 with offset. Not the request time, and not a provider-supplied timestamp.
  - **`updated_at`** _(string)_
    When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
  - **`created_at`** _(string)_
    When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
  - **`unreadable_fields`** _(array<object>)_
    Fields on this object that could not be read, and why. An empty array means everything was read. Use this to tell a real value from a missing one.
    - **`field`** _(string)_
      The property on this resource that could not be read.
    - **`reason`** _(string)_
      Why the field could not be read. available_on_get: Not read on list to keep the list fast; call GET for this resource's id to get it.
      Allowed: `not_supported_by_provider`, `not_configured`, `permission_denied`, `not_collected`, `collection_error`, `partially_collected`, `available_on_get`
    - **`detail`** _(string)_
      Additional detail on the reason, when there is any.
  - **`remote_data`** _(object)_
    Raw data returned from the remote API call.
  - **`policy_id`** _(string)_
    Provider reference for the policy, where one exists.
  - **`scope`** _(string)_
    Whether the policy applies to an account, a tenant, an organisational unit, or a directory.
    Allowed: `account`, `organisation`, `grouping`, `tenant`, `directory`
  - **`scope_id`** _(string)_
    The provider reference for the scope this policy applies to.
  - **`is_configured`** _(boolean)_
    Whether a policy has actually been set. On AWS, no policy (404 from GetAccountPasswordPolicy) means provider defaults apply -- a weaker posture -- and this is false, never unknown.
  - **`minimum_length`** _(integer)_
    Minimum password length.
  - **`reuse_prevention`** _(integer)_
    How many previous passwords cannot be reused.
  - **`expiry_days`** _(integer)_
    Maximum password age in days. Null with not_configured if the provider supports expiry but none is set; null with not_supported_by_provider if expiry doesn't exist at all.
  - **`hard_expiry`** _(boolean)_
    Whether an expired password locks the user out rather than prompting a reset.
  - **`lockout_threshold`** _(integer)_
    Failed sign-in attempts before lockout. AWS IAM has no such setting, so this is null with not_supported_by_provider -- never 0, which would misread as 'locks immediately'.
  - **`complexity_flags`** _(object)_
    Which character classes are required, as provider-named booleans -- for example require_symbols, require_numbers, require_uppercase, require_lowercase.
    - **`require_symbols`** _(boolean)_
      Whether at least one non-alphanumeric character is required.
    - **`require_numbers`** _(boolean)_
      Whether at least one digit is required.
    - **`require_uppercase`** _(boolean)_
      Whether at least one uppercase letter is required.
    - **`require_lowercase`** _(boolean)_
      Whether at least one lowercase letter is required.
    - **`allow_users_to_change_password`** _(boolean)_
      Whether users may change their own password without an administrator.
  - **`banned_password_protection`** _(boolean)_
    Whether the provider blocks known-breached or banned passwords. Null with not_supported_by_provider on AWS IAM, which has no such feature.
  - **`field_configurable`** _(object)_
    Per-field map of whether the customer can change that value, distinguishing 'fixed at 8' from 'set to 8'. On AWS the length floor is fixed at 6, reuse prevention capped at 24, and the symbol set fixed.
    - **`minimum_length`** _(boolean)_
      Whether the customer can change the minimum length.
    - **`reuse_prevention`** _(boolean)_
      Whether the customer can change how many previous passwords are remembered.
    - **`expiry_days`** _(boolean)_
      Whether the customer can change the password expiry period.
    - **`hard_expiry`** _(boolean)_
      Whether the customer can change whether an expired password locks the user out.
    - **`lockout_threshold`** _(boolean)_
      Whether the customer can change the failed-sign-in lockout threshold.
    - **`banned_password_protection`** _(boolean)_
      Whether the customer can change banned or breached password protection.
  - **`provenance`** _(string)_
    Where this policy came from. 'static' means the values are transcribed from the provider's documentation, not read live -- true of AWS Identity Center, which exposes no policy API.
    Allowed: `live`, `static`, `default`
- **`next_cursor`** _(string)_
  The cursor to use for the next page of results. Pass this value as `next_cursor` in the query parameter in the next request to get the next page of results.
- **`debug`** _(object)_
  Present only when `truto_response_format=debug`. Contains raw fetch details: `requestUrl`, `requestOptions`, `data`, `responseHeaders`, `nextCursor`, `isLooping`, `isEmptyResult`, `resultCount`. `data` is the parsed upstream body; when its JSON form exceeds 1 MiB it is replaced by `{ truto_truncated: true, truto_max_bytes, truto_excerpt }`, where `truto_excerpt` is the leading bytes of that body. The same applies to a string `requestOptions.body`. `null` for static responses or when `truto_skip_api_call=true`.
  - **`requestUrl`** _(string)_
  - **`requestOptions`** _(object)_
  - **`data`** _(unknown)_
  - **`responseHeaders`** _(object)_
  - **`nextCursor`** _(string)_
  - **`isLooping`** _(boolean)_
  - **`isEmptyResult`** _(boolean)_
  - **`resultCount`** _(number)_

## Code examples

### Truto CLI

```bash
truto unified cloud-infrastructure passwordpolicies \
  -a '<integrated_account_id>' \
  -o json
```

### Truto TS SDK

```typescript
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

const result = await truto.unifiedApi.list(
  'cloud-infrastructure',
  'passwordpolicies',
  { integrated_account_id: '<integrated_account_id>' }
);

console.log(result);
```

### Truto Python SDK

```python
import asyncio
from truto_python_sdk import TrutoApi

truto_api = TrutoApi(token="<your_api_token>")

async def main():
    async for item in truto_api.unified_api.list(
        "cloud-infrastructure",
        "passwordpolicies",
        {"integrated_account_id": "<integrated_account_id>"}
    ):
        print(item)

asyncio.run(main())
```

### curl

```bash
curl -X GET 'https://api.truto.one/unified/cloud-infrastructure/password_policies?integrated_account_id=<integrated_account_id>' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
```

### JavaScript

```javascript
const integratedAccountId = '<integrated_account_id>';

const response = await fetch(`https://api.truto.one/unified/cloud-infrastructure/password_policies?integrated_account_id=${integratedAccountId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
```

### Python

```python
import requests

url = "https://api.truto.one/unified/cloud-infrastructure/password_policies"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
    "integrated_account_id": "<integrated_account_id>"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())
```