Get a scheduled job

POST 
/api/v1/scheduler/get-job

Returns the metadata and current state of a single scheduled job by ID.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Manage jobs

Request

Responses

200

Scheduled job returned

Replace scheduleId with the ID returned when the job was created.

Section ID: DOC-CP-scheduling-api-getJob#example-scheduled-jobs-getJob-request

Request example

{
  "scheduleId": "sched_a1b2c3d4e5f60718"
}

Guide request for 1. Load the reminder being changed. Replace example resource identifiers with your own authorized values.

Section ID: DOC-CP-scheduling-api-getJob#example-cookbook-core-platform-scheduling-managing-01-request

Request example

{
  "scheduleId": "sched_a1b2c3d4e5f60718"
}

Guide request for Variant: use your application’s reminder identifier. Replace example resource identifiers with your own authorized values.

Section ID: DOC-CP-scheduling-api-getJob#example-cookbook-core-platform-scheduling-managing-09-request

Request example

{
  "externalId": "user-42-daily-digest"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-CP-scheduling-api-getJob#example-scheduled-jobs-getJob-response

Response example

{
  "scheduleId": "sched_a1b2c3d4e5f60718",
  "tenantId": "example_123",
  "projectId": "example_123",
  "ownerSubject": "example",
  "name": "example",
  "description": "example",
  "scheduleType": "SCHEDULE_TYPE_CRON",
  "cronExpression": "0 9 * * *",
  "timezone": "example",
  "scheduledAt": "2026-09-16T12:00:00Z",
  "intervalSeconds": 1,
  "target": {
    "url": "https://example.com/callback",
    "method": "example",
    "kind": "example",
    "payload": {
      "example": "value"
    }
  },
  "state": "SCHEDULE_STATUS_ACTIVE",
  "retryPolicy": {
    "maxAttempts": 1,
    "initialBackoffMs": 1,
    "maxBackoffMs": 1
  },
  "metadata": {
    "example": "value"
  },
  "autoPauseThreshold": 1,
  "externalId": "example_123",
  "createdAt": "2026-09-16T12:00:00Z",
  "createdBySubject": "example",
  "updatedAt": "2026-09-16T12:00:00Z",
  "updatedBySubject": "example",
  "pausedAt": "2026-09-16T12:00:00Z",
  "pausedBySubject": "example",
  "pausedReason": "example",
  "resumedAt": "2026-09-16T12:00:00Z",
  "resumedBySubject": "example",
  "deletedAt": "2026-09-16T12:00:00Z",
  "deletedBySubject": "example",
  "lastTriggeredAt": "2026-09-16T12:00:00Z",
  "nextTriggerAt": "2026-09-16T12:00:00Z",
  "triggerCount": "1",
  "failureCount": "1",
  "consecutiveFailureCount": "1"
}

Document ID: DOC-CP-scheduling-api-getJob. Section identities and revisions.

Section	Stable reference
Get a scheduled job	DOC-CP-scheduling-api-getJob#overview
Request	DOC-CP-scheduling-api-getJob#request
Responses	DOC-CP-scheduling-api-getJob#responses