# List ingestions

Retrieves a list of ingestions events that have been created for the specified dataset. 

The returned ingestionId values can be used with the corresponding ingestion details endpoint to retrieve more information about a specific ingestion event.

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

## Path parameters:

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

## Query parameters:

  - `page` (integer)
    The page number to retrieve. Pages are 1-indexed. Defaults to 1.
    Example: 1

  - `pageSize` (integer)
    The maximum number of results to return per page. Defaults to 100.
    Example: 100

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

  - `pagination` (object)
    Pagination metadata for the current response.

  - `pagination.page` (integer)
    The page number retrieved. Pages are 1-indexed.
    Example: 1

  - `pagination.pageSize` (integer)
    The maximum number of results to return per page.
    Example: 100

  - `pagination.totalItems` (integer)
    The total number of items matching the request, across all pages.
    Example: 1000

  - `ingestions` (array)
    List of ingestion events.

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

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

  - `ingestions.status` (string)
    Indicates the status of the ingestion event.
    Example: "success"

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