# Search jobs

Lists job execution records with optional filtering by status or flow, supporting pagination.

Request:
jobStatus   - Optional JobStatus filter (CREATED, RUNNING, COMPLETE, FAILED, SUSPENDED, CANCELED).
flowId      - Optional flow ID to return only jobs triggered by that specific flow.
pagination   - Optional Pagination cursor and page size for iterating large result sets.

Response:
jobs         - List of Job objects ordered by event date descending, including current status,
current task ID, payload, and execution timestamps.
pageCursor  - Opaque cursor to pass in a subsequent request to retrieve the next page.
Absent when there are no further results.

Endpoint: POST /api/v1/job/list
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `jobStatus` (integer)
    Enum: 0, 1, 2, 3, 4, 5, 6

  - `flowId` (string)
    Rule data fields

  - `pagination` (any)

  - `searchQuery` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `jobs` (array)

  - `jobs.id` (string)
    Rule data fields

  - `jobs.flowId` (string)
    Rule data fields

  - `jobs.jobStatus` (integer)
    Enum: 0, 1, 2, 3, 4, 5, 6

  - `jobs.name` (string)
    Rule data fields

  - `jobs.currentTaskId` (string)
    Rule data fields

  - `jobs.auditTrail` (object)

  - `jobs.auditTrail.trail` (array)

  - `jobs.auditTrail.trail.taskId` (string)
    Rule data fields

  - `jobs.auditTrail.trail.message` (string)
    Rule data fields

  - `jobs.auditTrail.trail.details` (string)
    Rule data fields

  - `jobs.auditTrail.trail.status` (integer)
    Enum: 0, 1, 2, 3, 4, 5, 6

  - `jobs.auditTrail.trail.createdDt` (object)

  - `jobs.auditTrail.trail.createdDt.seconds` (integer)

  - `jobs.auditTrail.trail.createdDt.nanos` (integer)

  - `jobs.startedBy` (string)
    Rule data fields

  - `jobs.startedDt` (object)

  - `jobs.updatedDt` (object)

  - `jobs.eventDt` (object)

  - `jobs.payload` (any)

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)