# How do recurring tasks and occurrences differ?

Company: Socra — Multiply Your Judgment
Canonical URL: https://support.socra.com/articles/art_01m3zvnwxgbz4w7xtcfqdcjc9s-task-and-occurrence

A task holds instructions and a schedule. An occurrence records one scheduled run. Complete an occurrence when that run finishes; complete the task when you want the entire recurring series to end.

To inspect the runs recorded for a task, replace `TASK_ID` with its returned ID:

```sh
socra task occurrence list TASK_ID
```

Occurrences are listed oldest first. If `has_more` is true, continue with `socra task occurrence list TASK_ID --after LAST_ID`, using the final occurrence ID from the previous page. Use the ID of the run that finished in the next command:

```sh
socra task occurrence complete OCCURRENCE_ID
```

For a recurring task, this leaves the task active and preserves future scheduling. Other pending occurrences remain separate. Completing an already completed occurrence returns its completed state; a canceled occurrence cannot be completed.

For a one-time task, completing its occurrence also completes the task. A recurring series ends when you run:

```sh
socra task complete TASK_ID
```

That command clears the next run, pauses the saved schedule, and cancels pending occurrences. Use it only when the whole series is finished.

An occurrence becoming due or being delivered to an Agent is not completion. Its status must be updated after the work finishes.

## Article details

- Collection: [Tasks](https://support.socra.com/collections/col_01m3xcq6237jk9besmvm5rq8zr-tasks)
- Canonical: https://support.socra.com/articles/art_01m3zvnwxgbz4w7xtcfqdcjc9s-task-and-occurrence