---
title: "GET /inma/collections/{collectionId}/ingestions/{ingestionId}/runs"
method: GET
path: "/inma/collections/{collectionId}/ingestions/{ingestionId}/runs"
tags: ["Ingestion Management"]
---

# GET /inma/collections/{collectionId}/ingestions/{ingestionId}/runs

`GET /inma/collections/{collectionId}/ingestions/{ingestionId}/runs`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/inma/collections/{collectionId}/ingestions/{ingestionId}/runs`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://geocatalog.spatio.azure.com/.default`

Get the runs of an ingestion

## Path parameters

- `collectionId` string, required
- `ingestionId` string, uuid, required

## Query parameters

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

## Response `200`

The request has succeeded.

- IngestionRunPagedResponse: Generic paged response model
  - `value` IngestionRun[], required: The items on the page
    - `id` string, uuid, required: Universally Unique Identifier
    - `parentRunId` string, uuid: Universally Unique Identifier
    - `operation` IngestionRunOperation, required: Microsoft Planetary Computer Pro geo-catalog ingestion run operation
      - `id` string, uuid, required: Universally Unique Identifier
      - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required: Operation status
      - `creationTime` string, date-time, required: The UTC time at which the operation was created
      - `statusHistory` OperationStatusHistoryItem[], required: The history of the operation status in time
        - `timestamp` string, date-time, required: The UTC time at which the status was set
        - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required: Operation status
        - `errorCode` string: If the status is failed, the error code
        - `errorMessage` string: If the status is failed, the error message
      - `startTime` string, date-time: The UTC time at which the operation was started
      - `finishTime` string, date-time: The UTC time at which the operation finished its execution
      - `totalItems` integer, required: The number of total items to be processed
      - `totalPendingItems` integer, required: The number of items pending to be processed
      - `totalSuccessfulItems` integer, required: The number of items successfully processed
      - `totalFailedItems` integer, required: The number of items that have failed to be processed
    - `creationTime` string, date-time, required: Creation time
    - `sourceCatalogUrl` string, uri: URL of the source catalog
    - `skipExistingItems` boolean: Skip any item that already exist in the GeoCatalog
    - `keepOriginalAssets` boolean: Keep original source assets
  - `nextLink` string, uri: Link to the next page of results

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-02-19** (2025-04-30-preview) `28e8cb365289`: 1 info
  - api operation id `IngestionRuns_ListAll` removed and replaced with `IngestionRuns_List`
- **2025-05-15** (2025-04-30-preview) `00cbc3d6d8e0`: 1 info
  - api operation id `IngestionRuns_List` removed and replaced with `IngestionRuns_ListAll`

[Operation history](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/changes/inma/collections/:collectionId/ingestions/:ingestionId/runs/get.md)

---

[API](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer.md) - [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/revisions/42447be18bc5?raw)