All Products
Search
Document Center

Qoder CN Series:List schedule runs

Last Updated:Jul 15, 2026

List Schedule Run execution records with pagination.

Request headers

Header

Required

Description

Authorization

Yes

Bearer <PAT>

Query parameters

Parameter

Type

Required

Default

Description

identity_id

string

Yes

-

Forward Identity ID that owns the Runs.

schedule_id

string

No

-

Filter by Schedule ID.

status

string

No

-

Filter by pending, running, completed, failed, or skipped.

trigger_type

string

No

-

Filter by schedule or manual.

has_error

boolean

No

-

Return only Runs with or without errors.

limit

integer

No

20

Page size, up to 100.

after_id

string

No

-

Cursor for the next page.

before_id

string

No

-

Cursor for the previous page.

Example request

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/schedule_runs' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "srun_019f00112233445566778899aabbccdd",
      "schedule_id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "session_id": "sess_019ec55a68b37e1e8d660691af161ab4",
      "status": "completed",
      "trigger_context": {
        "type": "schedule",
        "scheduled_at": "2026-06-22T01:00:00Z"
      },
      "result_payload": "Today's technology highlights: ...",
      "push_sink": "im_channel",
      "push_status": "succeeded",
      "push_finished_at": "2026-06-22T01:00:21Z",
      "attempt": 1,
      "triggered_at": "2026-06-22T01:00:00Z",
      "started_at": "2026-06-22T01:00:03Z",
      "completed_at": "2026-06-22T01:00:20Z",
      "duration_ms": 17000,
      "created_at": "2026-06-22T01:00:00Z"
    }
  ],
  "first_id": "srun_019f00112233445566778899aabbccdd",
  "last_id": "srun_019f00112233445566778899aabbccdd",
  "has_more": false
}

Response fields

Field

Type

Description

data

array

Schedule Run objects on the current page.

first_id

string | null

ID of the first Run on the current page.

last_id

string | null

ID of the last Run on the current page.

has_more

boolean

Whether more records are available.

Each item in data[] is a Schedule Run object with the same fields as Get schedule run, including trigger_context, error, push_sink, push_status, and execution timing fields.

Errors

HTTP

Type

Code

Trigger

400

invalid_request_error

invalid_identity

identity_id is missing or invalid.

400

invalid_request_error

invalid_pagination

Pagination parameters are invalid.

401

authentication_error

authentication_required

PAT invalid or expired.

Notes

  • Schedule Run is an independent resource.

  • completed, failed, and skipped are terminal states.

  • push_status tracks the IM streaming delivery status and is independent from the main status.