> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.select.dev/llms.txt > Use this file to discover all available pages before exploring further. # List usage groups in a set ## OpenAPI ````yaml https://api.select.dev/v2/openapi.json get /usage-group-sets/{usage_group_set_id}/usage-groups openapi: 3.1.0 info: title: SELECT API (v2) version: 0.1.0 servers: - url: https://api.select.dev/v2 description: SELECT API v2 security: [] paths: /usage-group-sets/{usage_group_set_id}/usage-groups: get: tags: - usage-group-sets summary: List usage groups in a set operationId: >- list_usage_groups_route_usage_group_sets__usage_group_set_id__usage_groups_get parameters: - name: usage_group_set_id in: path required: true schema: type: string title: Usage Group Set Id - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque cursor from a previous response. Omit on the first call. title: Page Token description: Opaque cursor from a previous response. Omit on the first call. - name: max_results in: query required: false schema: type: integer default: 50 title: Max Results - name: x-tenant-id in: header required: true schema: type: string description: The organization ID the request is scoped to. title: X-Tenant-Id description: The organization ID the request is scoped to. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListResponse_UsageGroupV2_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: ListResponse_UsageGroupV2_: properties: items: items: $ref: '#/components/schemas/UsageGroupV2' type: array title: Items page_token: anyOf: - type: string - type: 'null' title: Page Token description: Opaque cursor for the next page; empty/absent on the last page. row_count: anyOf: - type: integer - type: 'null' title: Row Count description: >- Best-effort total for the filtered result set; may be null when expensive. type: object required: - items title: ListResponse[UsageGroupV2] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError UsageGroupV2: properties: id: type: string title: Id create_time: type: string title: Create Time update_time: type: string title: Update Time usage_group_set_id: type: string title: Usage Group Set Id name: type: string title: Name budget: anyOf: - type: number - type: 'null' title: Budget order: type: integer title: Order filter_expression: $ref: >- #/components/schemas/FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output etag: type: string title: Etag type: object required: - id - create_time - update_time - usage_group_set_id - name - order - filter_expression - etag title: UsageGroupV2 ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: operator: type: string enum: - and - or title: Operator filters: items: anyOf: - $ref: >- #/components/schemas/FilterExpression_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output - $ref: >- #/components/schemas/InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output type: array title: Filters component_type: anyOf: - type: string const: Resource Filter - type: 'null' title: Component Type type: object required: - operator - filters title: >- FilterExpression[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] EqFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' title: Value operator: type: string enum: - '>' - '>=' - < - <= - '=' - '!=' title: Operator type: object required: - field - value - operator title: >- EqFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string enum: - in - not in title: Operator type: object required: - field - values - operator title: >- InFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] ArrayContainsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - additionalProperties: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - items: anyOf: - type: integer - type: number - type: boolean - type: string - type: string format: date - type: 'null' type: array - type: 'null' type: object - type: 'null' type: array title: Values operator: type: string const: array_contains title: Operator type: object required: - field - values - operator title: >- ArrayContainsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] IsFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: 'null' title: Value operator: type: string enum: - is - is not title: Operator type: object required: - field - operator title: >- IsFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] LikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - ilike - startswith - array_contains_prefix - array_contains_substring title: Operator type: object required: - field - value - operator title: >- LikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] MultiLikeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false values: items: type: string type: array title: Values operator: type: string enum: - ilike - startswith title: Operator type: object required: - field - values - operator title: >- MultiLikeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] InRelativeDateRangeFilter_Union_SemiStructuredDimension_SelectOrganizationUsageGroupDimensions___SelectOrganizationUsageGroupDimensions__-Output: properties: field: anyOf: - $ref: >- #/components/schemas/SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_ - $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' title: Field not: type: boolean title: Not default: false value: type: string title: Value operator: type: string enum: - in range - not in range title: Operator type: object required: - field - value - operator title: >- InRelativeDateRangeFilter[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] SemiStructuredDimension_SelectOrganizationUsageGroupDimensions_: properties: field: $ref: '#/components/schemas/SelectOrganizationUsageGroupDimensions' path: items: type: string type: array title: Path type: object required: - field - path title: SemiStructuredDimension[SelectOrganizationUsageGroupDimensions] SelectOrganizationUsageGroupDimensions: type: string enum: - bigquery_billed_project - bigquery_query_project - bigquery_source_type - connection_id - bigquery_reservation_labels_map - bigquery_reservation_labels - bigquery_organization - bigquery_billing_export_project - bigquery_billing_account - bigquery_reservation_id - bigquery_edition - bigquery_statement_type - bigquery_job_type - bigquery_pricing_model - bigquery_user_email - bigquery_principal_subject - bigquery_priority - bigquery_job_id - bigquery_query_dialect - bigquery_state - bigquery_error_reason - bigquery_admin_project_id - bigquery_query_pattern_id - databricks_pipeline_name - databricks_pipeline_tags - databricks_pipeline_tags_map - databricks_job_name - databricks_job_tags - databricks_job_tags_map - databricks_cluster_id - databricks_cluster_name - databricks_cluster_tags - databricks_cluster_tags_map - databricks_warehouse_id - databricks_sql_warehouse_name - databricks_warehouse_tags - databricks_warehouse_tags_map - databricks_app_name - databricks_base_environment_id - databricks_billing_origin_product - databricks_budget_policy_id - databricks_compute_resource_name - databricks_compute_size - databricks_data_quality_monitoring_schema_id - databricks_data_quality_monitoring_table_id - databricks_database_instance_id - databricks_genie_agent_id - databricks_genie_surface - databricks_is_photon - databricks_model_serving_endpoint_id - databricks_model_serving_endpoint_name - databricks_networking_associated_product - databricks_networking_client - databricks_networking_destination_region - databricks_networking_private_endpoint_name - databricks_networking_recipient_id - databricks_networking_source_region - databricks_notebook_path - databricks_storage_api_type - databricks_usage_type - databricks_account_id - databricks_workspace_id - databricks_workspace_name - databricks_compute_type - databricks_is_serverless - databricks_jobs_tier - databricks_sql_tier - databricks_dlt_tier - databricks_node_type - databricks_run_as - databricks_created_by - databricks_owned_by - databricks_sku_name - compute_pool_name - application_name - base_tables_accessed - base_schemas_accessed - base_databases_accessed - base_tables_accessed_csv - tables_modified - schemas_modified - databases_modified - tables_modified_csv - database_tags - database_tags_map - object_database_tags - object_database_tags_map - object_schema_tags - object_schema_tags_map - object_name_tags - object_name_tags_map - object_level_tags - object_level_tags_map - resource_type - nice_resource_type - identifying_metadata - dbt_node_tags - dbt_target_database_schema_name - dbt_resource_database_schema_name - usage_group_metadata - task_database_name - task_database_schema_name - task_fully_qualified_name - stored_procedure_database_name - stored_procedure_database_schema_name - stored_procedure_fully_qualified_name - dynamic_table_database_name - dynamic_table_database_schema_name - dynamic_table_fully_qualified_name - warehouse_name - warehouse_tags - warehouse_tags_map - user_name - user_tags - user_tags_map - role_name - role_tags - role_tags_map - database_name - schema_name - database_schema_name - fivetran_database_schema_name - custom_workload_app_workload_id - query_type - snowflake_intelligence_instance - snowflake_account_name - snowflake_org_name - account_name - account_locator - region - service_level - managed_by - account_name_and_warehouse - usage_type - account_name_and_usage_type - account_metadata - connection_type - platform_organization - platform_instance - platform_instance_name securitySchemes: HTTPBearer: type: http description: Organization API key (sl_…). scheme: bearer ````