---
title: "List all jobs"
method: GET
path: "/hyperv/v1/orgs/{OrgID}/reports/jobs"
tags: ["Hyper-V"]
---

# List all jobs

`GET /hyperv/v1/orgs/{OrgID}/reports/jobs`

## Request

- Base URL: `//apis.druva.com/phoenix` (relative, and the document’s source URL is not known)
- URL: `//apis.druva.com/phoenix/hyperv/v1/orgs/{OrgID}/reports/jobs`
- Auth: API key in header `Authorization`

Returns a list of all jobs for Hyper-V.

## Path parameters

- `OrgID` integer, required

## Query parameters

- `jobType` integer[]
- `status` integer[]
- `pageToken` string
- `vmName` string[]
- `hostName` string[]
- `fromTime` integer
- `toTime` integer
- `sortOrder` string

## Response `200`

Success

- HVGetAllJobsReportResponse
  - `jobs` HVHyperVAllJob[]: List of all jobs run for Hyper-V.
    - `clusterName` string: The name of Cluster
    - `endTime` string: The time when the job operation ends. The time is specified in the UTC time zone. The format is YYYY-MM-DDTHH:MM:SSZ.
    - `errorCode` string: Specifies the error code when the backup operation fails. The possible values are:\n \"0\": If the job is successful\n <error_number>: If the job has failed
    - `errorMessage` string: Specifies the message for rhe failed job. This field is empty if the job is successful.
    - `host` string: The name of the Hyper-V host. Multiple host names can be separated by commas. Get the list of the Hyper-V host names using the 'ListHost' API.
    - `jobID` integer: Specifies a unique identification number associated with the job.
    - `jobType` string: Specifies the type of the job. This parameter can be set to one or more of the following values: Backup, Restore, Log Request and Defreeze. Specify multiple job types by separating them with commas. See <a href=https://help.druva.com/en/articles/8651316-monitor-hyper-v-jobs>Job Types.</a>
    - `organizationName` string: The name of the organization.
    - `scvmmName` string: The name of System Center Virtual Machine Manager(SCVMM).
    - `startTime` string: The time when the job operation starts. The time is specified in the UTC time zone. The format is YYYY-MM-DDTHH:MM:SSZ.
    - `status` string: Specify the status of the job. This parameter can be set to one or more of the following values: Queued, Running, Successful, Successful with errors and Failed. Specify multiple status values by separating them with commas.
    - `vmName` string: The name of the VM for which the job is initiated. Specify multiple VM names by separating them with commas.
  - `nextPageToken` string: The token to access the next page of results. This parameter will be empty for the last page of results.

## Other responses

- `400`: Bad Request
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error in the Cloud.

---

[API](https://skmtc.dev/druva/apis/enterprise-workloads.md) - [All operations](https://skmtc.dev/druva/apis/enterprise-workloads/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/enterprise-workloads/revisions/18fc75e8229e?raw)