---
title: "ListProvisioningResults returns a list of provisioning results in a specified namespace."
method: GET
path: "/v1/namespaces/{tenant_meta.namespace}/provisioning-results"
tags: ["ProvisioningResultService"]
---

# ListProvisioningResults returns a list of provisioning results in a specified namespace.

`GET /v1/namespaces/{tenant_meta.namespace}/provisioning-results`

## Path parameters

- `tenant_meta.namespace` string, required

## Query parameters

- `list_parameters.filter` string
- `list_parameters.page_token` integer
- `list_parameters.page_size` integer
- `list_parameters.action` string
- `list_parameters.mask` string
- `list_parameters.traverse` boolean
- `list_parameters.sort.path` string
- `list_parameters.sort.order` 'SORT_ENTRY_ORDER_UNSPECIFIED' | 'SORT_ENTRY_ORDER_ASC' | 'SORT_ENTRY_ORDER_DESC'
- `list_parameters.count` boolean
- `list_parameters.group.aggregation_paths` string
- `list_parameters.group.show_aggregation_uuids` boolean
- `list_parameters.group.unique_count_paths` string
- `list_parameters.group.unique_value_paths` string
- `list_parameters.ci_run_uuid` string
- `list_parameters.page_id` string
- `list_parameters.group_by_time.aggregation_paths` string
- `list_parameters.group_by_time.show_aggregation_uuids` boolean
- `list_parameters.group_by_time.interval` 'GROUP_BY_TIME_INTERVAL_UNSPECIFIED' | 'GROUP_BY_TIME_INTERVAL_YEAR' | 'GROUP_BY_TIME_INTERVAL_QUARTER' | 'GROUP_BY_TIME_INTERVAL_MONTH' | 'GROUP_BY_TIME_INTERVAL_WEEK' | 'GROUP_BY_TIME_INTERVAL_DAY' | 'GROUP_BY_TIME_INTERVAL_HOUR' | 'GROUP_BY_TIME_INTERVAL_MINUTE' | 'GROUP_BY_TIME_INTERVAL_SECOND'
- `list_parameters.group_by_time.group_size` integer
- `list_parameters.group_by_time.start_time` string, date-time
- `list_parameters.group_by_time.end_time` string, date-time
- `list_parameters.group_by_time.mode` string
- `list_parameters.group_by_time.aggregation_value_field` string
- `list_parameters.group_by_time.aggregation_operator` string
- `list_parameters.disable_pagination` boolean

## Response `200`

A successful response.

- V1ListProvisioningResultsResponse — ListProvisioningResultsResponse is used by ListProvisioningResults.
  - `count_response` V1CountResponse — Response to a list count request.
    - `count` integer — Number of objects matching the given list parameters.
  - `group_response` V1GroupResponse — Response to a list group request.
    - `groups` object — Map indexed by values of the fields specified in aggregation_paths, for example, {"[{"key":"meta.kind","value":"Project"}]": { "aggregation_count": { "count": 1649 } } }.
  - `list` V1ListProvisioningResultsResponseList
    - `objects` V1ProvisioningResult[]
      - `context` V1Context, required — Contexts keep objects from different scans separated.
        - `id` string, required — The context ID, such as a pull request ID or branch reference.
        - `tags` string[] — A list of tags applied to a context. Used primarily for CI and SBOM contexts.
        - `type` 'CONTEXT_TYPE_UNSPECIFIED' | 'CONTEXT_TYPE_MAIN' | 'CONTEXT_TYPE_EXTERNAL' | 'CONTEXT_TYPE_CI_RUN' | 'CONTEXT_TYPE_SBOM' | 'CONTEXT_TYPE_REF', required — - CONTEXT_TYPE_MAIN: Objects from a scan of the default branch. All objects in the oss namespace are in the main context. The context id is always "default". - CONTEXT_TYPE_EXTERNAL: Indicates that this object is a copy/temporary value of an object in another project. Used for same-tenant dependencies. In source code reference this is equivalent to "vendor" folders. Package versions in the external context are only scanned for call graphs. No other operations are performed on them. - CONTEXT_TYPE_CI_RUN: Objects from a PR scan. The context id is the PR UUID. Objects in this context are deleted after 30 days. - CONTEXT_TYPE_SBOM: Objects from an SBOM scan. The context id is the SBOM serial number or some other unique identifier. - CONTEXT_TYPE_REF: Objects from a scan of a specific branch. The context id is the branch reference name.
        - `will_be_deleted_at` string, date-time — Time that all objects in this context will be deleted. This field is deprecated and will be removed in the future. Please use the meta.will_be_deleted_at field instead.
      - `meta` V1Meta, required — Common fields for all Endor Labs resources.
        - `annotations` object — Annotations can be used to attach metadata to a resource message. Annotation values can be small or large, structured or unstructured, and may include characters not permitted by labels. The keys may contain alphanumerics, underscores (_), dots (.) and dashes (-). The values of an annotation must be 16384 bytes or smaller.
        - `create_time` string, date-time — Time the resource was created. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
        - `created_by` string — Name and authentication source of the user who created the object, for example, ewok@endor.ai@google@api-key.
        - `description` string — Resource description. Must be less than 1024 bytes.
        - `index_data` V1IndexData — IndexData is used to index the resource for search. It's an internal object.
          - `data` string[]
          - `search_score` number, float — search_score is the score of the resource for search. Internal use only.
          - `tenant` string
          - `will_be_deleted_at` string, date-time — Time that the resource will be deleted.
        - `kind` string — Resource kind, for example, HelloResponse. Auto-generated using the protobuf message proto.MessageName().Name().
        - `name` string, required — Resource name. Must be 63 characters or less.
        - `parent_kind` string — Parent object resource kind, for example, Project.
        - `parent_uuid` string — Parent object UUID.
        - `references` object — Map of objects referenced in a query API.
        - `tags` string[] — List of tags attached to the resource. Tags can be used to select objects and to find collections of objects that satisfy certain conditions. A tag must be 255 characters or less.
        - `update_time` string, date-time — Time the resource was last updated. Note: Updated on all create/patch/delete operations. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
        - `updated_by` string — Name and authentication source of the last user who updated the object, for example, vulnerabilityingestor@endor.ai@x509.
        - `upsert_time` string, date-time — Time the resource was last upserted. Note: create_time is only set the first time the resource is created. upsert_time is set every time the resource is upseted. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
        - `version` string — Message version.
      - `spec` V1ProvisioningResultSpec, required — Spec is the internal specification of the object.
        - `arch` string, required — The OS architecture where the provisioning occurred.
        - `auto_detect_result` V1AutoDetectResult — Message for an auto detect result.
          - `detected_tool_chain_versions` object
          - `detected_versions` object — Detected versions by lanaguage.
          - `error` string — Auto detect error message.
          - `tool_chains` V1ToolChains
            - `android_tool_chain` V1AndroidToolChain
              - …
            - `dotnet_tool_chain` V1DotNetToolChain
              - …
            - `environment_variables` string[] — environment_variables are the env variables to be set during toolchain installation.
            - `golang_tool_chain` V1GolangToolChain
              - …
            - `java_tool_chain` V1JavaToolChain
              - …
            - `javascript_tool_chain` V1JavaScriptToolChain
              - …
            - `php_tool_chain` V1PHPToolChain
              - …
            - `python_tool_chain` V1PythonToolChain
              - …
            - `ruby_tool_chain` V1RubyToolChain
              - …
            - `rust_tool_chain` V1RustToolChain
              - …
            - `scala_tool_chain` V1ScalaToolChain
              - …
            - `swift_tool_chain` V1SwiftToolChain
              - …
        - `automated_scan_parameters_config` V1AutomatedScanParametersConfig — Message for automated scan parameter configuration.
          - `automated_scan_parameters_source` 'AUTOMATED_SCAN_PARAMETERS_SOURCE_UNSPECIFIED' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_API' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_FILE' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_NAMESPACE_DEFAULT' — Automated scan parameter source types.
          - `resolved_scan_environment_variables` string[] — Resolved environment variables.
        - `automated_scan_parameters_source` 'AUTOMATED_SCAN_PARAMETERS_SOURCE_UNSPECIFIED' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_API' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_FILE' | 'AUTOMATED_SCAN_PARAMETERS_SOURCE_NAMESPACE_DEFAULT' — Automated scan parameter source types.
        - `error` string — Provisioning error message.
        - `exit_code` integer, required — Provisioning exit code.
        - `languages_detected` string[] — Languages detected.
        - `os` string, required — The OS where the provisioning occurred.
        - `project_url` string, required — Repository URL of the project for which the scan is run.
        - `provisioning_config` SpecProvisioningConfig — Message for provisioning configuration.
          - `bazel_remote_cache` string — GRPC address of the bazel remote cache. If enabled, tool chain downloads are cached locally in the cluster.
          - `enable_build_tools_version_detection` boolean — Whether build tool detection was enabled.
          - `endorctl_version` string — Endorctl version.
          - `insecure_sandbox` boolean — Whether an insecure scanbox was specified.
          - `install_build_tools` boolean — Whether build tools where installed.
          - `install_build_tools_dependencies` boolean — Whether install build tools dependencies was enabled.
          - `sandbox_debug` boolean — Whether sandbox debugging was enabled.
          - `use_automated_scan_parameters` boolean — Whether use automated scan parameters was enabled.
        - `sandbox_config` SpecSandboxConfig — Message for sandbox configuration.
          - `bazel_version` string — Bazel version.
          - `custom_script_config` SandboxConfigCustomScriptConfig — Message for custom script configuration.
            - `exit_code` integer — Custom script exit code.
            - `stderr` string — Custom script stderr.
            - `stdout` string — Custom script stdout.
            - `tool_chains` V1ToolChains
              - …
          - `environment_variables` string[] — Sanbox environment variables.
          - `sandbox_strategy` 'SANDBOX_STRATEGY_TYPE_UNSPECIFIED' | 'SANDBOX_STRATEGY_TYPE_PROCESSWRAPPER' | 'SANDBOX_STRATEGY_TYPE_LINUX' | 'SANDBOX_STRATEGY_TYPE_DARWIN' — Sandbox strategy types.
          - `writable_paths` string[] — Sandbox writable paths.
        - `scan_profile` V1ScanProfile — ScanProfile represents the scan configuration to use across different projects.
          - `meta` V1Meta, required — Common fields for all Endor Labs resources.
            - `annotations` object — Annotations can be used to attach metadata to a resource message. Annotation values can be small or large, structured or unstructured, and may include characters not permitted by labels. The keys may contain alphanumerics, underscores (_), dots (.) and dashes (-). The values of an annotation must be 16384 bytes or smaller.
            - `create_time` string, date-time — Time the resource was created. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
            - `created_by` string — Name and authentication source of the user who created the object, for example, ewok@endor.ai@google@api-key.
            - `description` string — Resource description. Must be less than 1024 bytes.
            - `index_data` V1IndexData — IndexData is used to index the resource for search. It's an internal object.
              - …
            - `kind` string — Resource kind, for example, HelloResponse. Auto-generated using the protobuf message proto.MessageName().Name().
            - `name` string, required — Resource name. Must be 63 characters or less.
            - `parent_kind` string — Parent object resource kind, for example, Project.
            - `parent_uuid` string — Parent object UUID.
            - `references` object — Map of objects referenced in a query API.
            - `tags` string[] — List of tags attached to the resource. Tags can be used to select objects and to find collections of objects that satisfy certain conditions. A tag must be 255 characters or less.
            - `update_time` string, date-time — Time the resource was last updated. Note: Updated on all create/patch/delete operations. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
            - `updated_by` string — Name and authentication source of the last user who updated the object, for example, vulnerabilityingestor@endor.ai@x509.
            - `upsert_time` string, date-time — Time the resource was last upserted. Note: create_time is only set the first time the resource is created. upsert_time is set every time the resource is upseted. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt.
            - `version` string — Message version.
          - `propagate` boolean — Indicates that the object should be visible in the child namespaces.
          - `spec` V1ScanProfileSpec, required — Spec is the internal specification of the object.
            - `ai_sast_analysis_parameters` V1AISastAnalysisParameters — Runtime parameters controlling behavior of ai sast analysis.
              - …
            - `automated_scan_parameters` V1AutomatedScanParameters — AutomatedScanParameters represents the parameters that must be applied during automated cloud scans to the projects associated with the corresponding profile.
              - …
            - `exporter_parameters` SpecExporterParameters
              - …
            - `is_default` boolean — is_default indicates that the scan profile is the namespace default.
            - `remediation_parameters` V1RemediationParameters — RemediationParameters holds the settings for remediation actions.
              - …
            - `security_review_scanner_parameters` SpecSecurityReviewScannerParameters
              - …
            - `toolchain_profile` V1ToolChainProfile — ToolChainProfile represents the list of tool chains that need to be installed.
              - …
          - `tenant_meta` V1TenantMeta, required — Tenant related data for the tenant containing the resource.
            - `namespace` string, required — Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app".
          - `uuid` string — UUID is a universally unique identifier for the tool chain profile.
        - `tool_chains` V1ToolChains
          - `android_tool_chain` V1AndroidToolChain
            - `command_line_tools_version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `packages` string[]
          - `dotnet_tool_chain` V1DotNetToolChain
            - `additional_dotnet_versions` string[]
            - `dotnet_installer_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `environment_variables` string[] — environment_variables are the env variables to be set during toolchain installation.
          - `golang_tool_chain` V1GolangToolChain
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `java_tool_chain` V1JavaToolChain
            - `gradle_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `maven_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `javascript_tool_chain` V1JavaScriptToolChain
            - `nodejs_version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `npm_packages` object
            - `pnpm_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `rush_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `yarn_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `php_tool_chain` V1PHPToolChain
            - `composer_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `python_tool_chain` V1PythonToolChain
            - `pip_packages` object — the key is the package name to install through pip.
            - `poetry_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `ruby_tool_chain` V1RubyToolChain
            - `dependabot_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `ruby_gems` object
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `rust_tool_chain` V1RustToolChain
            - `mirai_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `rustup_version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `scala_tool_chain` V1ScalaToolChain
            - `java_version` V1ToolChainVersion — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
          - `swift_tool_chain` V1SwiftToolChain
            - `additional_swift_versions` string[]
            - `version` V1ToolChainVersion, required — ToolChainVersion defines the tool chain's source from where it can be installed.
              - …
        - `tool_chains_source` 'TOOL_CHAINS_SOURCE_UNSPECIFIED' | 'TOOL_CHAINS_SOURCE_API' | 'TOOL_CHAINS_SOURCE_FILE' | 'TOOL_CHAINS_SOURCE_AUTO_DETECTION' | 'TOOL_CHAINS_SOURCE_DEFAULTS' | 'TOOL_CHAINS_SOURCE_NAMESPACE_DEFAULT' — Toolchain source types.
      - `tenant_meta` V1TenantMeta, required — Tenant related data for the tenant containing the resource.
        - `namespace` string, required — Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app".
      - `uuid` string — UUID is a universally unique identifier for the provisioning result.
    - `response` V1ListResponse — Response to a list request.
      - `next_page_id` string — The UUID of last message retrieved.
      - `next_page_token` integer — Pagination token that can be used to retrieve the next page of results.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/endorlabs/apis/endor-labs-rest-api-reference.md) · [All operations](https://skmtc.net/endorlabs/apis/endor-labs-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/endorlabs/endor-labs-rest-api-reference/revisions/2fe1f84213b3/schema)
