---
title: "Completion feed for a list"
method: GET
path: "/lists/{list_id}/completions"
tags: ["lists"]
---

# Completion feed for a list

`GET /lists/{list_id}/completions`

## Request

- Base URL: `https://app.tascan.io/api/v1`
- URL: `https://app.tascan.io/api/v1/lists/{list_id}/completions`
- Auth: HTTP bearer

Completions on one list created strictly after the cursor, oldest first, at most 100: completion_id, task_id, task_title, response_value, notes, worker_name, status, completed_at. Pass back next_since exactly as returned (and next_after to break a tie on the same instant); with nothing new, the cursor is echoed unchanged. Lets an agent hear when its owner answers a card without re-reading the list. Read tier.

## Path parameters

- `list_id` string, required

## Query parameters

- `since` string
- `after` string, uuid

## Response `200`

Success. JSON body: { data: ... } or an error object { error, message }.

## Other responses

- `4XX`: Client error (validation, auth, scope, rate limit).

---

[API](https://skmtc.dev/tascan/apis/tascan-api.md) · [All operations](https://skmtc.dev/tascan/apis/tascan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tascan/apis/tascan-api/revisions/56fcd2861498?raw)
