---
title: "List authorized bulk jobs"
method: GET
path: "/v1/bulk/jobs"
---

# List authorized bulk jobs

`GET /v1/bulk/jobs`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/bulk/jobs`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Lists retained jobs in the current authority; only jobs whose action remains authorized are visible. Pagination is cursor based and bound to authority and state.

## Query parameters

- `cursor` string
- `limit` integer
- `state` 'preparing' | 'awaiting_confirmation' | 'queued' | 'running' | 'paused' | 'blocked' | 'completed' | 'completed_with_failures' | 'cancelled' | 'expired' | 'refused'

## Response `200`

List authorized bulk jobs

- object
  - `data` object[], required
    - `id` string, required
    - `authority` object, required
      - `environment` string, required
      - `environmentKind` 'test' | 'live', required
      - `organization` string, required
      - `project` string, required
    - `intent` union, required
      - object
        - `target` 'schedules' | 'parent_schedules' | 'occurrences', required
        - `selection` union, required
          - object
            - `kind` 'ids', required
            - `resource` 'schedules', required
            - `ids` string[], required
          - object
            - `kind` 'ids', required
            - `resource` 'executions', required
            - `ids` string[], required
          - object
            - `kind` 'all_matching', required
            - `resource` 'schedules', required
            - `filter` object, required
              - …
          - object
            - `kind` 'all_matching', required
            - `resource` 'executions', required
            - `filter` object, required
              - …
        - `operation` 'retry', required
        - `parameters` object, required
          - `includeSucceeded` boolean
      - object
        - `target` 'schedules' | 'parent_schedules' | 'occurrences', required
        - `selection` union, required
          - object
            - `kind` 'ids', required
            - `resource` 'schedules', required
            - `ids` string[], required
          - object
            - `kind` 'ids', required
            - `resource` 'executions', required
            - `ids` string[], required
          - object
            - `kind` 'all_matching', required
            - `resource` 'schedules', required
            - `filter` object, required
              - …
          - object
            - `kind` 'all_matching', required
            - `resource` 'executions', required
            - `filter` object, required
              - …
        - `operation` 'reschedule', required
        - `parameters` union, required
          - object
            - `mode` 'absolute', required
            - `at` string, required
          - object
            - `mode` 'shift_existing', required
            - `seconds` integer, required
          - object
            - `mode` 'delay_from_reference', required
            - `seconds` integer, required
          - object
            - `mode` 'definition', required
            - `definition` union, required
              - …
      - object
        - `target` 'schedules' | 'parent_schedules' | 'occurrences', required
        - `selection` union, required
          - object
            - `kind` 'ids', required
            - `resource` 'schedules', required
            - `ids` string[], required
          - object
            - `kind` 'ids', required
            - `resource` 'executions', required
            - `ids` string[], required
          - object
            - `kind` 'all_matching', required
            - `resource` 'schedules', required
            - `filter` object, required
              - …
          - object
            - `kind` 'all_matching', required
            - `resource` 'executions', required
            - `filter` object, required
              - …
        - `operation` 'cancel', required
        - `parameters` object, required
      - object
        - `target` 'schedules' | 'parent_schedules' | 'occurrences', required
        - `selection` union, required
          - object
            - `kind` 'ids', required
            - `resource` 'schedules', required
            - `ids` string[], required
          - object
            - `kind` 'ids', required
            - `resource` 'executions', required
            - `ids` string[], required
          - object
            - `kind` 'all_matching', required
            - `resource` 'schedules', required
            - `filter` object, required
              - …
          - object
            - `kind` 'all_matching', required
            - `resource` 'executions', required
            - `filter` object, required
              - …
        - `operation` 'pause', required
        - `parameters` object, required
      - object
        - `target` 'schedules' | 'parent_schedules' | 'occurrences', required
        - `selection` union, required
          - object
            - `kind` 'ids', required
            - `resource` 'schedules', required
            - `ids` string[], required
          - object
            - `kind` 'ids', required
            - `resource` 'executions', required
            - `ids` string[], required
          - object
            - `kind` 'all_matching', required
            - `resource` 'schedules', required
            - `filter` object, required
              - …
          - object
            - `kind` 'all_matching', required
            - `resource` 'executions', required
            - `filter` object, required
              - …
        - `operation` 'resume', required
        - `parameters` object, required
    - `state` 'preparing' | 'awaiting_confirmation' | 'queued' | 'running' | 'paused' | 'blocked' | 'completed' | 'completed_with_failures' | 'cancelled' | 'expired' | 'refused', required
    - `version` integer, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `referenceAt` string, required
    - `preparationExpiresAt` string, required
    - `previewExpiresAt` string
    - `executionExpiresAt` string
    - `resultsExpireAt` string
    - `intentDigest` string
    - `complete` boolean, required
    - `counts` object, required
      - `matched` integer, required
      - `eligible` integer, required
      - `ineligible` integer, required
      - `pending` integer, required
      - `running` integer, required
      - `succeeded` integer, required
      - `noOp` integer, required
      - `skipped` integer, required
      - `conflicted` integer, required
      - `failed` integer, required
      - `cancelled` integer, required
    - `reasons` object[], required
      - `reason` 'eligible' | 'already_active' | 'already_paused' | 'already_cancelled' | 'invalid_state' | 'unsupported_target' | 'expired_input' | 'unauthorized' | 'concurrently_changed' | 'past_time' | 'attempt_limit' | 'operation_failed' | 'transient_failure' | 'selection_too_large' | 'preparation_incomplete' | 'preview_expired' | 'job_expired' | 'job_cancelled' | 'quota_exceeded' | 'spending_limit' | 'in_flight', required
      - `count` integer, required
    - `warnings` string[], required
    - `samples` object[], required
      - `id` string, required
      - `jobId` string, required
      - `scheduleId` string, required
      - `occurrenceId` string
      - `state` 'pending' | 'running' | 'succeeded' | 'no_op' | 'skipped' | 'conflicted' | 'failed' | 'cancelled', required
      - `reason` 'eligible' | 'already_active' | 'already_paused' | 'already_cancelled' | 'invalid_state' | 'unsupported_target' | 'expired_input' | 'unauthorized' | 'concurrently_changed' | 'past_time' | 'attempt_limit' | 'operation_failed' | 'transient_failure' | 'selection_too_large' | 'preparation_incomplete' | 'preview_expired' | 'job_expired' | 'job_cancelled' | 'quota_exceeded' | 'spending_limit' | 'in_flight', required
      - `eligible` boolean, required
      - `retryable` boolean, required
      - `fence` string, required
      - `before` object, required
        - `status` string
        - `plannedFor` string
        - `recurrence` string
        - `timeZone` string
        - `affectedFutureRuns` integer
        - `latenessPolicy` 'skipAhead' | 'catchUp'
        - `maxStalenessSeconds` integer
        - `overlapPolicy` 'skip' | 'queue'
        - `nextRunNote` string
      - `after` object
        - `status` string
        - `plannedFor` string
        - `recurrence` string
        - `timeZone` string
        - `affectedFutureRuns` integer
        - `latenessPolicy` 'skipAhead' | 'catchUp'
        - `maxStalenessSeconds` integer
        - `overlapPolicy` 'skip' | 'queue'
        - `nextRunNote` string
      - `attemptId` string
      - `actionId` string
      - `updatedAt` string, required
      - `expiresAt` string
    - `limits` object, required
      - `maxTargets` integer, required
      - `executionLifetimeSeconds` integer, required
      - `previewLifetimeSeconds` integer, required
      - `resultRetentionSeconds` integer, required
      - `batchSize` integer, required
      - `workerConcurrency` integer, required
    - `billing` object, required
      - `additionalAttemptsMinimum` integer, required
      - `additionalAttemptsMaximum` integer
      - `currentLimits` object
        - `capturedAt` string, required
        - `billingMode` 'disabled' | 'shadow' | 'enforced', required
        - `attemptsPerOccurrence` integer, required
        - `dailyAttemptQuota` 'none', required
        - `availableCreditMicrodollars` string
        - `spendingCapMicrodollars` string, nullable
        - `remainingToSpendingCapMicrodollars` string
      - `exactChargeKnown` false, required
      - `note` string, required
    - `reason` 'eligible' | 'already_active' | 'already_paused' | 'already_cancelled' | 'invalid_state' | 'unsupported_target' | 'expired_input' | 'unauthorized' | 'concurrently_changed' | 'past_time' | 'attempt_limit' | 'operation_failed' | 'transient_failure' | 'selection_too_large' | 'preparation_incomplete' | 'preview_expired' | 'job_expired' | 'job_cancelled' | 'quota_exceeded' | 'spending_limit' | 'in_flight'
  - `nextCursor` string

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `404`: Problem document. Possible codes at this status: not_found.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)