---
title: "Get List of Scan Jobs"
method: GET
path: "/api/discovery-scan-config/v2/scan-job/datasource/{dataSourceId}"
tags: ["Scan Jobs"]
---

# Get List of Scan Jobs

`GET /api/discovery-scan-config/v2/scan-job/datasource/{dataSourceId}`

Use this API to retrieve a list of all scan jobs in JSON format for the specified data source. The response will include relevant details for each scan job, including the corresponding scan job ID, created date, and cancelled date.

## Path parameters

- `dataSourceId` string, uuid, required

## Query parameters

- `status` string[]
- `scanLevel` string[]
- `isManual` boolean
- `createdFrom` string, date-time
- `createdTo` string, date-time
- `page` integer — Results page to be retrieved (0..N).
- `size` integer — Number of records per page (1..50). Maximum page size allowed is 50
- `sort` 'status,asc' | 'status,desc' | 'scanLevel,asc' | 'scanLevel,desc' | 'createdDate,asc' | 'createdDate,desc' — Sorting criteria in the format: property(,asc|desc). Default is ascending.

## Response `200`

List of scan jobs

- DataUseGovernanceDataDiscoveryPageWrapperMetadataScanJobDto
  - `content` DataUseGovernanceDataDiscoveryMetadataScanJobV2Dto[] — The content of this page.
    - `name` string — Name of Scan job
    - `sourceSystemId` string, uuid, required — Source System ID for Scan job
    - `scannerId` string, uuid, required — Scanner ID for Scan Job
    - `status` 'QUEUED' | 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'ABORTED' | 'STOPPED_AS_LOAD_ABORTED' | 'CANCELLED' | 'CANCELLING' | 'FAILED' | 'PAUSED' | 'PAUSING' | 'RESUMING', required — Scan job scan status
    - `statusMessage` string — Scan job status message
    - `scanLevel` 'INCREMENTAL_SCAN' | 'FULL_SCAN' | 'SCAN' | 'SOURCING' | 'CATALOG' | 'CATALOG_SCAN' | 'QUERY' | 'FILE_RETRIEVAL' | 'OFFSET_REPORT' | 'CATALOG_POLICY_SCAN' | 'ASSET_DISCOVERY' | 'DATA_ELEMENT_DISCOVERY' | 'POLICY_ORCHESTRATION_APPLY' | 'POLICY_ORCHESTRATION_UNAPPLY' | 'POLICY_ORCHESTRATION_EDIT' | 'POLICY_ORCHESTRATION_DELETE' | 'ROLE_INGESTION' | 'AI_ASSET_DISCOVERY' | 'GUARDRAIL_POLICY_ENFORCEMENT' — Scan Job scan level
    - `isManual` boolean
    - `isVoyager` boolean
    - `jobContext` object
    - `expectedRecordCount` integer — Scan Job expected record count
    - `failedRecordCount` integer — Scan Job failed record count
    - `successRecordCount` integer — Scan Job success record count
    - `cancelledRecordCount` integer — Scan Job cancelled record count
    - `scannedMetadataCount` integer — Scan Job scanned metadata count
    - `uploadedMetadataCount` integer — Scan Job uploaded metadata count
    - `failedIngestionCount` integer — Scan Job failed ingestion count
    - `createdDate` string, date-time — Scan Job creation date
    - `createdBy` string, uuid — User who created Scan Job
    - `jobProgress` number, double — Scan Jobs progress
    - `updatedDate` string, date-time — Scan Job updated date
    - `updatedBy` string, uuid — user who last updated scan job
    - `cancelledBy` string, uuid — user who cancelled scan job
    - `cancelledDate` string, date-time — Scan Job cancelled date
    - `pausedBy` string, uuid — user who paused scan job
    - `pausedDate` string, date-time — Scan Job paused date
    - `resumedBy` string, uuid — user who resumed scan job
    - `resumedDate` string, date-time — Scan Job resumed date
    - `classifiedTermsCount` integer — Scan Job classified terms count
    - `ingestionStatus` 'AWAITING' | 'PUBLISHING' | 'PUBLISHED' | 'NONE' — Scan Job ingestion status
    - `ingestionDate` string, date-time — Scan Job ingestion date
    - `ingestedMetadataVolume` integer — Scan job ingestion metadata volume in bytes
    - `scannedCount` string — Scan Job Scan count
    - `totalContentSize` integer — Scan Job total content size in bytes
    - `scanProfile` DataUseGovernanceDataDiscoveryScanProfileV2Dto
      - `id` string, uuid, required — Unique ID for Scan Profile
      - `name` string, required — Name of Scan Profile
      - `scanType` 'CATALOG' | 'CATALOG_SCAN', required — Scan Type of Scan Profile
      - `sourceType` 'SEED' | 'USER_DEFINED' — Source of this Scan Profile
      - `systemName` string, required — System Name of Scan Profile
      - `scanProfileContext` object, required — Properties of Scan Profile Specific to System
      - `systemType` 'RELATIONAL_DATABASE' | 'NON_RELATIONAL_DATABASE' | 'FILE' | 'API' | 'CUSTOM' | 'UNKNOWN' | 'CLOUD_PLATFORM' | 'MACHINE_LEARNING_PLATFORM', required — System Type of Scan Profile
      - `createdDate` string, date-time — Creation Date of Scan Profile
      - `displayName` string — Display Name for System Name of Scan Profile
    - `retryAttempts` integer — Total Retry Attempts for scan job failures
    - `maxRetries` integer — Max Retries allowed for scan job failures
    - `idleScanDuration` integer — Idle time of scan when Paused (or) during retry
    - `scanDuration` integer — Actual Scan duration
    - `scanStartedDate` string, date-time — Actual Scan start date
    - `id` string, uuid
    - `manual` boolean
    - `voyager` boolean
  - `number` integer — Current page number.
  - `size` integer — The size of the page (number of elements per page).
  - `numberOfElements` integer — The number of elements on the current page.
  - `totalElements` integer — The total number of elements across all pages.
  - `totalPages` integer — The total number of pages.
  - `first` boolean — Indicates if this is the first page.
  - `last` boolean — Indicates if this is the last page.
  - `empty` boolean — Indicates if the page is empty.
  - `sort` DataUseGovernanceDataDiscoverySort
    - `sort` string[]
  - `pageable` DataUseGovernanceDataDiscoveryPageable
    - `page` integer
    - `size` integer
    - `sort` string[]

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)
