---
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`

## Request

- Base URL: `https://public.api.serval.com`
- URL: `https://public.api.serval.com/v2/entity-ingestion-configs/{ingestion_config_id}/runs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/serval/apis/serval-public-api/docs/v2/entity-ingestion-configs/:ingestion_config_id/runs/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/serval/apis/serval-public-api.md) - [All operations](https://skmtc.dev/serval/apis/serval-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/serval/apis/serval-public-api/revisions/0549515e9384?raw)