Skip to main content

List Policy

GET 
/api/v1/infra/collections/:collectionId/policies

Retrieves a paginated list of all IAM policies assigned to a specific user within a collection. Returns policy summaries including names, types, attachment status, and basic metadata for access management review.

Path Parameter Note: If the collections list returns a "provider not supported" error code, use "default" as the collectionId value.

Parameter Details​

Header Parameters​

  • integrationid (required): Unique identifier for the cloud provider integration configured in your Unizo account. This UUID associates the API request with the specific cloud account credentials and permissions. Use the integration ID from your Unizo dashboard under Connectors → [Provider] → Integration Details.

Path Parameters​

  • collectionId (required): Unique identifier for the collection within the specified cloud provider. Format varies by provider:
    • AWS: Region identifier for compliance environments (e.g., us-east-1 for US compliance, eu-west-1 for GDPR compliance)
    • Google Cloud: Project ID for governance environments (e.g., prod-compliance-env, audit-data-project-2024)
    • Azure: Use "default" when no specific subscription or resource group mapping is configured
    • Other providers: Provider-specific collection identifiers

Query Parameters​

  • offset: Starting position for pagination (default: 0). Use this to skip a specific number of policy records when processing compliance audit reports. For example, offset=20 starts from the 21st policy for large governance reviews.

  • limit: Maximum number of policies to return per page (default: 50, max: 200). Optimize performance by requesting only the number of records you need for compliance assessments and audit workflows.

  • sort: Sort policies by field name for governance reporting. Use field names directly (e.g., name) or prefix with - for descending order (e.g., -name). Multiple fields supported for compliance analysis: name,-type,description.

Request​

Responses​

Successful Operation