Tasks

List occurrences for a task

Required API-key scope: tasks:read.

get /tasks/{task_object_id}/occurrences

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Path Parameters

task_object_id string required

Task object id

Query Parameters

status string | null
page_token integer | null
page_size integer | null

200application/json

Paginated list of occurrences

items object[] required
created_at string required
deadline_ms integer | null
dispatched_at_ms integer | null
dispatched_tx_digest string | null
execution_object_id string | null
id integer<int32> required
missed_at_ms integer | null
occurrence_id integer<int64> required

Chain-assigned occurrence id, unique within its task.

priority_fee_percentage integer<int64> required
source string required

standalone or recurring.

source_iteration integer | null

Iteration index; set only when source is recurring.

start_ms integer<int64> required
status string required
succeeded boolean | null

Set when status is settled.

task_object_id string required
updated_at string required
withdrawal_reason string | null

Set when status is withdrawn.

metadata object required

Pagination metadata included in every listing response.

next_token integer | null

Token to pass as page_token to retrieve the next page. null means there are no more pages.

total_items integer<int64> required

Total number of items across all pages.

400

Invalid filter value

404

Task was not found

500

Internal server error