---
title: "Get a job"
method: GET
path: "/jobs/{jobId}"
tags: ["Jobs", "Beta"]
---

# Get a job

`GET /jobs/{jobId}`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/jobs/{jobId}`
- Auth: API key in header `X-ESCAPE-API-KEY`

Returns job status, parameters, and artefacts (including signedUrl download links for completed export outputs).

## Path parameters

- `jobId` string, uuid, required: The job ID

## Response `200`

OK

- object
  - `id` string, uuid, required
  - `status` 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING', required
  - `kind` 'INTEGRATION_WIZ_RESEND_ISSUES' | 'MAINTENANCE_RECOMPUTE_ISSUES_FULLNAME' | 'SAAS_AI_FALSE_POSITIVE_DETECTION' | 'SAAS_AI_FALSE_POSITIVE_DETECTION_ON_ISSUE' | 'SAAS_ARCHIVE_SCAN' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_AGENT_TOOL_CALL' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_EXCHANGE' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_GENERATED_OPENAPI_SPEC' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_GRAPH' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_SCREENSHOT' | 'SAAS_ARCHIVE_SCAN_DELETE_ATTACHMENT_SNIPPET' | 'SAAS_ARCHIVE_SCAN_DELETE_EVENTS' | 'SAAS_ARCHIVE_SCAN_DELETE_TARGETS' | 'SAAS_ARTEFACTS_S3_MIGRATION' | 'SAAS_ASSET_FILES_S3_MIGRATION' | 'SAAS_ASSET_SCHEMA_S3_MIGRATION' | 'SAAS_ATTACHMENTS_S3_MIGRATION' | 'SAAS_BATCHED_SCHEDULE_ASM_SCANS' | 'SAAS_BATCHED_UPDATE_CACHED_DATA' | 'SAAS_BATCHED_UPDATE_ISSUE_COUNTS' | 'SAAS_BULK_CREATE_ASSETS' | 'SAAS_CANCEL_RUNNING_SCANS' | 'SAAS_CHECK_LOCATION_DOWN' | 'SAAS_DELETE_APPLICATION' | 'SAAS_DELETE_ASSETS' | 'SAAS_DELETE_INTEGRATION' | 'SAAS_DELETE_ORGANIZATION' | 'SAAS_DELETE_PROJECT' | 'SAAS_END_SCAN_ROUTINE' | 'SAAS_EOS' | 'SAAS_EOS_ADVANCE_CONTINUOUS_COMMIT' | 'SAAS_EOS_ARCHIVE_OLD_SCANS' | 'SAAS_EOS_CLEAR_SUMMARIES' | 'SAAS_EOS_FINALIZE' | 'SAAS_EOS_FINISH_AGENTS' | 'SAAS_EOS_MERGE_TARGETS' | 'SAAS_EOS_RECONCILE_TECH' | 'SAAS_EOS_RESOLVE_ISSUES' | 'SAAS_EOS_SCHEDULE_FOLLOW_UPS' | 'SAAS_EOS_SCHEDULE_WORKFLOWS' | 'SAAS_EOS_SEND_FINISHED' | 'SAAS_EOS_UPDATE_COUNTS_RISKS' | 'SAAS_EOS_UPDATE_SCORES' | 'SAAS_EVENTS_ARCHIVE_GENERATION' | 'SAAS_EXCHANGES_ARCHIVE_GENERATION' | 'SAAS_EXECUTE_CONTINUOUS_PENTEST' | 'SAAS_EXECUTE_SCHEDULE' | 'SAAS_EXECUTE_WORKFLOW' | 'SAAS_EXPORT_TEMPLATE' | 'SAAS_GC_ARCHIVED_SCAN_TARGETS' | 'SAAS_GC_ORPHAN_ATTACHMENTS' | 'SAAS_GENERATE_ISSUE_REMEDIATION' | 'SAAS_GENERATE_PENTEST_ASSESSMENT_EXECUTIVE_SUMMARY' | 'SAAS_GENERATE_PENTEST_EXECUTIVE_SUMMARY' | 'SAAS_GENERATE_PENTEST_PROFILE_EXECUTIVE_SUMMARY' | 'SAAS_GENERATE_PENTEST_REMEDIATION_SUMMARY' | 'SAAS_HANDLE_GITHUB_WEBHOOK' | 'SAAS_OFFLOAD_ATTACHMENTS' | 'SAAS_OFFLOAD_EXCHANGE_BODIES' | 'SAAS_POPULATE_ASSET_SCAN_MTM' | 'SAAS_POPULATE_ISSUE_SCAN_MTM' | 'SAAS_PROCESS_FILE_UPLOAD' | 'SAAS_REBUILD_ASSET_LINKS' | 'SAAS_RECOMPUTE_ASSET_RISKS' | 'SAAS_RECONCILE_ORG_SCHEDULES' | 'SAAS_SCHEDULE_ASSET_SCAN_MTM_POPULATION' | 'SAAS_SCHEDULE_DEFAULT_VIEWS_SEED' | 'SAAS_SCHEDULE_ISSUE_SCAN_MTM_POPULATION' | 'SAAS_SCHEDULE_WORKFLOWS' | 'SAAS_SEED_DEFAULT_VIEWS' | 'SAAS_START_ASM_SCAN' | 'SAAS_START_CONTINUOUS_PENTEST' | 'SAAS_TEMPORARY_SYNC_SCHEMAS_AND_SERVICES' | 'SAAS_UPSERT_ASM_PROFILES' | 'SEND_JOB_ARTEFACTS_BY_EMAIL' | 'TEST_KIND', required
  - `name` string, nullable, required
  - `createdAt` string, required
  - `scheduledAt` string, nullable, required
  - `triggeredAt` string, nullable, required
  - `completedAt` string, nullable, required
  - `parameters` unknown
  - `error` object, nullable, required: Failure message. Credentials and secrets are redacted.
    - `message` string, required
  - `reason` string, nullable, required: Why the job was triggered.
  - `retries` integer, required
  - `retriedAt` string[], required
  - `artefacts` object[], required
    - `id` string, uuid, required
    - `kind` 'AUDITOR_REPORT' | 'EVENTS_ARCHIVE' | 'EXCHANGES_ARCHIVE' | 'EXECUTIVE_REPORT' | 'EXPORT_JOB_RESULT', required
    - `name` string, required
    - `signedUrl` string, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400`: Bad Request
- `404`: Not found

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)