# Fetch a list of all virtualization jobs

Endpoint: GET /virtualization-jobs/history
Version: 3.30.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 100.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies descending order.

  - `object_id` (string)
    The object id to filter by.

  - `object_type` (string)
    The object type to filter by.

  - `job_type` (string)
    The job type to filter by.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.engine_job_id` (string)
    ID of the virtualization engine job.

  - `items.engine_id` (string)
    ID of the RegisteredEngine.

  - `items.legacy_job_type` (string)
    Legacy type of the job.

  - `items.job_type` (string)
    A DCT specific job type
    Enum: "REPLICATION_PROFILE_EXECUTE", "OFFLINE_REPLICATION_RECEIVE"

  - `items.target_object_id` (string)
    ID of the target object.

  - `items.legacy_target_object_type` (string)
    Legacy type of the target object.

  - `items.target_object_type` (string)
    A DCT specific object type.
    Enum: "REPLICATION_PROFILE"

  - `items.job_state` (string)
    Enum: "RUNNING", "COMPLETED", "SUSPENDED", "CANCELED", "FAILED"

  - `items.start_time` (string)
    The time the job started.

  - `items.update_time` (string)
    The time the job was last updated.

  - `items.suspendable` (boolean)
    Indicates whether the job can be suspended.

  - `items.cancelable` (boolean)
    Indicates whether the job can be canceled.

  - `items.queued` (boolean)
    Indicates whether the job is queued.

  - `items.title` (string)
    The title of the job.

  - `items.cancel_reason` (string)
    The reason the job was canceled.

  - `items.percent_complete` (integer)
    The percentage of the job that is complete.

  - `items.run_duration` (integer)
    The time this job took to complete in milliseconds.

  - `items.events` (array)
    The events associated with this job.

  - `items.events.event_type` (string)
    The type of the event.
    Enum: "INFO", "WARNING", "ERROR"

  - `items.events.event_timestamp` (string)
    The time the event occurred.

  - `items.events.event_state` (string)
    The state of the event.
    Enum: "INITIAL", "RUNNING", "SUSPENDED", "CANCELED", "COMPLETED", "RETRYABLE", "FAILED"

  - `items.events.percent_complete` (integer)
    The percentage of the event that is complete.

  - `items.events.message_code` (string)
    Message ID associated with the event.

  - `items.events.message_details` (string)
    Localized message details.

  - `items.events.message_action` (string)
    Localized message action.

  - `items.events.message_command_output` (string)
    Command output associated with the event, if applicable.

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.