# Retrieve an ingestion

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

Endpoint: GET /v1/datasets/{datasetId}/ingestions/{ingestionId}
Version: v1
Security: x-api-key

## Path parameters:

  - `datasetId` (string, required)
    Unique identifier for the dataset.
    Example: "4e1219d8-7fa8-44b7-96c6-a8f2a9cfb0bf"

  - `ingestionId` (string, required)
    Unique identifier for the ingestion event.
    Example: "8bfba187-84f4-41e2-9dd3-bee4bb884205"

## Response 200 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "success"

  - `ingestionId` (string)
    Unique identifier for the ingestion event.
    Example: "8bfba187-84f4-41e2-9dd3-bee4bb884205"

  - `timestamp` (string)
    Example: "2025-10-01T12:00:00.000000Z"

  - `metrics` (object)
    Metrics summarizing dataset characteristics and the outcome of the ingestion event

  - `metrics.datasetMetrics` (object)
    Metrics describing the current state of the dataset.

  - `metrics.datasetMetrics.columnsCount` (integer)
    Number of columns in the dataset.
    Example: 20

  - `metrics.datasetMetrics.datasetSizeMB` (number)
    Current size of the dataset in megabytes.
    Example: 12.3456789

  - `metrics.datasetMetrics.totalDatasetRecordsCount` (integer)
    Total number of records stored in the dataset.
    Example: 500000

  - `metrics.ingestionMetrics` (object)
    Metrics describing the result of the ingestion.

  - `metrics.ingestionMetrics.appendedRecordsCount` (integer)
    Number of records successfully appended to the dataset.
    Example: 100

  - `metrics.ingestionMetrics.receivedRecordsCount` (integer)
    Total number of records received in the ingestion request.
    Example: 100

  - `metrics.ingestionMetrics.rejectedRecordsCount` (integer)
    Number of records rejected due to errors or validation issues.

  - `metrics.ingestionMetrics.overwrittenRecordsCount` (integer)
    Number of records that were overwritten in the dataset.

## Response 400 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "error"

  - `errors` (array)

  - `errors.code` (string,null)
    A machine-readable error code that identifies the type of error.
    Example: "invalid_input"

  - `errors.message` (string)
    A human-readable message explaining the error.
    Example: "The provided parameter is invalid."

  - `errors.field` (string)
    The name of the request field associated with the error, if applicable.
    Example: "datasetId"

  - `errors.type` (string)
    The category or context of the error, such as validation or permission.
    Example: "validation"

## Response 401 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "error"

  - `errors` (array)

  - `errors.code` (string,null)
    A machine-readable error code that identifies the type of error.
    Example: "invalid_input"

  - `errors.message` (string)
    A human-readable message explaining the error.
    Example: "The provided parameter is invalid."

  - `errors.field` (string)
    The name of the request field associated with the error, if applicable.
    Example: "datasetId"

  - `errors.type` (string)
    The category or context of the error, such as validation or permission.
    Example: "validation"