---
title: "List Entity Ingestion Runs"
method: GET
path: "/v2/entity-ingestion-configs/{ingestion_config_id}/runs"
tags: ["Entity Ingestion Config API"]
---

# List Entity Ingestion Runs

`GET /v2/entity-ingestion-configs/{ingestion_config_id}/runs`

List the ingestion runs for an entity ingestion config, most-recent-first, including status, per-item counts, and any failure. Use to verify that ingested data landed.

## Path parameters

- `ingestion_config_id` string, required — The ingestion config whose runs to list.

## Query parameters

- `pageSize` integer — Maximum number of runs to return. Default is 10, maximum is 50.
- `pageOffset` integer — Number of runs to skip (for pagination).

## Response `200`

Success

- SvstorePublicapiListEntityIngestionRunsResponse
  - `data` SvstoreEntityIngestionRun[] — The ingestion runs, most-recent-first.
    - `id` string
    - `ingestionConfigId` string
    - `status` 'ENTITY_INGESTION_RUN_STATUS_UNSPECIFIED' | 'ENTITY_INGESTION_RUN_STATUS_RUNNING' | 'ENTITY_INGESTION_RUN_STATUS_COMPLETED' | 'ENTITY_INGESTION_RUN_STATUS_FAILED' — EntityIngestionRunStatus is the lifecycle state of a single ingestion run.
    - `startedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `completedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `itemsAddedCount` integer, nullable
    - `itemsUpdatedCount` integer, nullable
    - `itemsDeletedCount` integer, nullable
    - `itemsUnchangedCount` integer, nullable
    - `itemsErroredCount` integer, nullable
    - `failureReason` 'ENTITY_INGESTION_RUN_FAILURE_REASON_UNSPECIFIED' | 'ENTITY_INGESTION_RUN_FAILURE_REASON_DATA_INGESTION' | 'ENTITY_INGESTION_RUN_FAILURE_REASON_SCHEMA_EXTRACTION' | 'ENTITY_INGESTION_RUN_FAILURE_REASON_INFERENCE' | 'ENTITY_INGESTION_RUN_FAILURE_REASON_PUBLISHING' — EntityIngestionRunFailureReason identifies which phase of the pipeline failed.
    - `failureMessage` string
    - `svRunId` string
    - `isFullSync` boolean

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/revisions/0549515e9384/schema)