# Retrieve a dataset ingestion

Retrieves details about the specified dataset ingestion.

Endpoint: GET /v2/datasets/{id}/ingestions/{ingestionId}
Version: v2
Security: x-api-key

## Security:

  - `x-api-key` (unknown)
    apiKey in header x-api-key

## Path parameters:

  - `id` (integer, required)

  - `ingestionId` (string, required)

## Header parameters:

  - `x-account-id` (integer)
    The ID of an account to perform this request against, instead of the organization tied to the API key.
Only relevant for organizations with accounts; omit this header to act on the organization associated with the authenticated credential.

## Response 200:

  - `200` (unknown)
    Successful response containing the dataset ingestion.

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

  - `data` (object)
    Details about a dataset ingestion.

  - `data.id` (string)
    Unique identifier for the ingestion.
    Example: a4283796-bfde-42cf-aa65-1830d6692966

  - `data.initiatedAt` (string)
    Date and time when the operation was initiated.
    Example: 2026-09-18T12:00:00.000000+00:00

  - `data.status` (string)
    Current status of the resource.

  - `data.duration` (integer)
    Duration of the operation, in milliseconds.
    Example: 200

  - `data.initiatedBy` (object)
    Basic information identifying a user.

  - `data.initiatedBy.id` (integer)
    Unique identifier for the user.
    Example: 123456

  - `data.initiatedBy.name` (string)
    Full name of the user.
    Example: Anna Lytics

  - `data.summary` (object)
    Record, column, and storage totals for the ingestion.

  - `data.summary.ingestion` (object)
    Record counts for the ingestion request itself.

  - `data.summary.ingestion.receivedRecordCount` (integer)
    Number of records received for ingestion.
    Example: 500

  - `data.summary.ingestion.appendedRecordCount` (integer)
    Number of records appended to the dataset.
    Example: 500

  - `data.summary.ingestion.overwrittenRecordCount` (integer)
    Number of existing records overwritten during ingestion.
    Example: 10

  - `data.summary.ingestion.rejectedRecordCount` (integer)
    Number of records rejected during ingestion.
    Example: 0

  - `data.summary.dataset` (object)
    Totals for the dataset after the ingestion was applied.

  - `data.summary.dataset.columnCount` (integer)
    Number of columns in the dataset, including calculated columns.
    Example: 6

  - `data.summary.dataset.rowCount` (integer)
    Number of rows in the dataset.
    Example: 1000

  - `data.summary.dataset.size` (integer)
    Amount of storage currently used, in bytes.
    Example: 104857600

  - `data.errors` (array)
    Errors encountered during ingestion.

  - `data.errors.code` (string)
    Machine-readable error code that identifies the type of error.
    Example: invalid_input

  - `data.errors.message` (string)
    Human-readable description of the result or error.

  - `data.errors.field` (string)
    Field associated with the ingestion error.

  - `data.errors.record` (object)
    Record associated with the ingestion error.

## Response 401:

  - `401` (unknown)
    Error response indicating that the API key is missing or invalid.

## 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 that occurred while processing the request.

  - `errors.code` (string)
    Machine-readable error code that identifies the type of error.
    Example: invalid_input

  - `errors.message` (string)
    Human-readable description of the error, including the underlying validation message when available.
    Example: The provided parameter is invalid.

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

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

## Response 404:

  - `404` (unknown)
    Error response indicating that the specified resource could not be found.

## Response 404 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 that occurred while processing the request.

  - `errors.code` (string)
    Machine-readable error code that identifies the type of error.
    Example: invalid_input

  - `errors.message` (string)
    Human-readable description of the error, including the underlying validation message when available.
    Example: The provided parameter is invalid.

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

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