---
title: "Get Seed Job Status"
method: GET
path: "/v3/entities/seed/{id}"
tags: ["Entity Bulk Seed"]
---

# Get Seed Job Status

`GET /v3/entities/seed/{id}`

## Path parameters

- `id` string, required

## Response `200`

The request has succeeded.

- SeedJobStatusResponseV3 — `GET /v3/entities/seed/{id}` response.
  - `seedJobID` string, required — Public ID (`esj_...`) of the seed job.
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — Lifecycle state.
  - `totalRows` integer, required — Total rows in the submitted batch.
  - `createdCount` integer, required — Rows that created a new entity.
  - `mergedCount` integer, required — Rows merged into an existing entity.
  - `rejectedCount` integer, required — Rows rejected.
  - `results` SeedRowResultV3[] — Per-row outcomes. Present only once `status` is `completed`.
    - `canonical` string, required — The canonical name from the input row.
    - `outcome` 'created' | 'merged-with' | 'rejected', required — What happened to this row: `created` (new entity), `merged-with` (matched an existing entity), or `rejected` (see `reason`).
    - `entityID` string — Public ID (`ent_...`) of the created or merged entity. Absent when rejected.
    - `reason` string — Human-readable explanation when `outcome` is `rejected`.
  - `error` string — Terminal error message when `status` is `failed`.

---

[API](https://skmtc.net/bem-team/apis/bem-api.md) · [All operations](https://skmtc.net/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bem-team/bem-api/versions/b0a6debb3458/schema)