---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/runs"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/runs"
tags: ["Runs"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/runs

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/runs`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/runs`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Gets all the runs for a registry.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `registryName` string, required

## Query parameters

- `api-version` string, required
- `$filter` string
- `$top` integer

## Response `200`

The request was successful; the request was well-formed and received properly.

- RunListResult: Collection of runs.
  - `value` Run[]: The collection value.
    - `id` string: The resource ID.
    - `name` string: The name of the resource.
    - `type` string: The type of the resource.
    - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
      - `createdBy` string: The identity that created the resource.
      - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
      - `createdAt` string, date-time: The timestamp of resource creation (UTC).
      - `lastModifiedBy` string: The identity that last modified the resource.
      - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
      - `lastModifiedAt` string, date-time: The timestamp of resource modification (UTC).
    - `properties` RunProperties: The properties for a run.
      - `runId` string: The unique identifier for the run.
      - `status` 'Queued' | 'Started' | 'Running' | 'Succeeded' | 'Failed' | 'Canceled' | 'Error' | 'Timeout': The current status of the run.
      - `lastUpdatedTime` string, date-time: The last updated time for the run.
      - `runType` 'QuickBuild' | 'QuickRun' | 'AutoBuild' | 'AutoRun': The type of run.
      - `agentPoolName` string: The dedicated agent pool for the run.
      - `createTime` string, date-time: The time the run was scheduled.
      - `startTime` string, date-time: The time the run started.
      - `finishTime` string, date-time: The time the run finished.
      - `outputImages` ImageDescriptor[]: The list of all images that were generated from the run. This is applicable if the run generates base image dependencies.
        - `registry` string: The registry login server.
        - `repository` string: The repository name.
        - `tag` string: The tag name.
        - `digest` string: The sha256-based digest of the image manifest.
      - `task` string: The task against which run was scheduled.
      - `imageUpdateTrigger` ImageUpdateTrigger: The image update trigger that caused a build.
        - `id` string: The unique ID of the trigger.
        - `timestamp` string, date-time: The timestamp when the image update happened.
        - `images` ImageDescriptor[]: The list of image updates that caused the build.
          - `registry` string: The registry login server.
          - `repository` string: The repository name.
          - `tag` string: The tag name.
          - `digest` string: The sha256-based digest of the image manifest.
      - `sourceTrigger` SourceTriggerDescriptor: The source trigger that caused a run.
        - `id` string: The unique ID of the trigger.
        - `eventType` string: The event type of the trigger.
        - `commitId` string: The unique ID that identifies a commit.
        - `pullRequestId` string: The unique ID that identifies pull request.
        - `repositoryUrl` string: The repository URL.
        - `branchName` string: The branch name in the repository.
        - `providerType` string: The source control provider type.
      - `timerTrigger` TimerTriggerDescriptor
        - `timerTriggerName` string: The timer trigger name that caused the run.
        - `scheduleOccurrence` string: The occurrence that triggered the run.
      - `platform` PlatformProperties: The platform properties against which the run has to happen.
        - `os` 'Windows' | 'Linux', required: The operating system type required for the run.
        - `architecture` 'amd64' | 'x86' | '386' | 'arm' | 'arm64': The OS architecture.
        - `variant` 'v6' | 'v7' | 'v8': Variant of the CPU.
      - `agentConfiguration` AgentProperties: The properties that determine the run agent configuration.
        - `cpu` integer: The CPU configuration in terms of number of cores required for the run.
      - `sourceRegistryAuth` string: The scope of the credentials that were used to login to the source registry during this run.
      - `customRegistries` string[]: The list of custom registries that were logged in during this run.
      - `runErrorMessage` string: The error message received from backend systems after the run is scheduled.
      - `updateTriggerToken` string: The update trigger token passed for the Run.
      - `logArtifact` ImageDescriptor: Properties for a registry image.
        - `registry` string: The registry login server.
        - `repository` string: The repository name.
        - `tag` string: The tag name.
        - `digest` string: The sha256-based digest of the image manifest.
      - `provisioningState` 'Creating' | 'Updating' | 'Deleting' | 'Succeeded' | 'Failed' | 'Canceled': The provisioning state of a run.
      - `isArchiveEnabled` boolean: The value that indicates whether archiving is enabled or not.
  - `nextLink` string: The URI that can be used to request the next set of paged results.

## Other responses

- `default`: Error response describing why the operation failed.

## Changes

- **2026-07-13** (2018-09-01) `c76ca489295c`: 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`

[Operation history](https://skmtc.dev/azure/apis/containerregistry-microsoft-containerregistry-registrytasks/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.ContainerRegistry/registries/:registryName/runs/get.md)

---

[API](https://skmtc.dev/azure/apis/containerregistry-microsoft-containerregistry-registrytasks.md) - [All operations](https://skmtc.dev/azure/apis/containerregistry-microsoft-containerregistry-registrytasks/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/containerregistry-microsoft-containerregistry-registrytasks/revisions/5892ec92e590?raw)
