---
title: "Retrieve an ingestion"
method: GET
path: "/v1/datasets/{datasetId}/ingestions/{ingestionId}"
tags: ["Datasets"]
---

# Retrieve an ingestion

`GET /v1/datasets/{datasetId}/ingestions/{ingestionId}`

Retrieves detailed information for an ingestion event, allowing you to check processing progress and outcomes.

## Path parameters

- `datasetId` string, uuid, required — Unique identifier for the dataset.
- `ingestionId` string, uuid, required — Unique identifier for the ingestion event.

## Response `200`

Successful response containing detailed information about the requested ingestion event.

- object — List of ingestion events.
  - `requestId` string — Unique identifier for the request.
  - `status` string — Indicates the status of the request.
  - `ingestionId` string, uuid — Unique identifier for the ingestion event.
  - `timestamp` string
  - `metrics` Metrics — Metrics summarizing dataset characteristics and the outcome of the ingestion event.
    - `datasetMetrics` object — Metrics describing the current state of the dataset.
      - `columnsCount` integer — Number of columns in the dataset.
      - `datasetSizeMB` number, double — Current size of the dataset in megabytes.
      - `totalDatasetRecordsCount` integer — Total number of records stored in the dataset.
    - `ingestionMetrics` object — Metrics describing the result of the ingestion.
      - `appendedRecordsCount` integer — Number of records successfully appended to the dataset.
      - `receivedRecordsCount` integer — Total number of records received in the ingestion request.
      - `rejectedRecordsCount` integer — Number of records rejected due to errors or validation issues.
      - `overwrittenRecordsCount` integer — Number of records that were overwritten in the dataset.

## Other responses

- `400` — Error response indicating one or more request parameters are invalid.
- `401` — Error response indicating that the API key is missing or invalid.

---

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