---
title: "Get an ingestion job's results"
method: GET
path: "/inventory/ingestions/{id}/results"
tags: ["Inventory"]
---

# Get an ingestion job's results

`GET /inventory/ingestions/{id}/results`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/inventory/ingestions/{id}/results`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `agentic:inventory`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/inventory/ingestions/:id/results/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the per-item results report for a terminal ingestion job. By default only the rejected
rows are listed, so you can fix and re-submit them; pass `include=all` to list every row.
Returns `409 results_not_ready` until the job is terminal.

Requires the `agentic:inventory` scope. A job owned by another merchant returns `404`.

## Path parameters

- `id` string, required

## Query parameters

- `include` 'all'

## Response `200`

The per-item results report.

- InventoryIngestionResults: <span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p> The per-item results report for a terminal ingestion job. By default `items` lists only the rejected rows; request `?include=all` to list every row.
  - `ingestion_id` string: The ingestion identifier the report belongs to.
  - `counts` InventoryIngestionCounts: <span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p> The running item tally for an ingestion job. `pending` reaches `0` when the job is terminal.
    - `received` integer: The number of items received in the batch or parsed from the file.
    - `accepted` integer: The number of items applied successfully so far.
    - `rejected` integer: The number of items rejected so far, each recorded in the results report.
    - `pending` integer: The number of items still to be processed. `0` once the job is terminal.
  - `items` InventoryIngestionItemResult[]: The list of per-item outcomes.
    - `index` integer: The zero-based position of the item in the submitted batch or file.
    - `variant_id` string: The variant identifier the item targeted.
    - `status` 'accepted' | 'rejected': Whether the item was applied or rejected.
    - `error_codes` string[]: The collection of one or more machine-readable rejection codes, in the `[subject]_[error]` form. Empty for an accepted item.

## Other responses

- `401`: Missing or invalid token.
- `403`: The token does not carry the `agentic:inventory` scope.
- `404`: The ingestion does not exist, or is owned by another merchant (`ingestion_not_found`).
- `409`: The job has not reached a terminal state yet (`results_not_ready`).
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)