Skip to main content

List Collections

GET 
/api/v1/infra/collections

Returns a list of Collection objects. These objects represent organizational units that are native to each cloud provider. Collection types include:

  • Google Cloud: Projects (type: "project")
  • AWS: Regions (type: "region")
  • Azure: default (type: "default") - A single collection when no specific subscription or resource group mapping is configured
  • Other providers: Provider-specific organizational structures

Collections use the tool's native terminology and serve as logical groupings for infrastructure resources within each cloud service providers.

API Usage Note: When using chaining APIs that require a collection ID parameter, use the collection ID returned from this endpoint. For Azure integrations with default collections, the collection ID will be "default".

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.

Query Parameters​

  • offset: Starting position for pagination (default: 0). Use this to skip a specific number of collection records. For example, offset=100 when auditing large environments with hundreds of compliance scopes.

  • limit: Maximum number of collections to return per page (default: 50, max: 200). For compliance auditing, consider using smaller batches (e.g., limit=25) to process governance reviews systematically.

  • sort: Sort collections by field name for structured compliance reporting. Examples:

    • name - Alphabetical for audit documentation
    • -lastUpdatedDateTime - Recent changes first for change management review
    • type,-name - Group by collection type, then alphabetical for governance categorization

Request​

Responses​

Successful Operation