---
title: "List the Social checklist with this workspace's status"
method: GET
path: "/social/checklist/items"
tags: ["Social checklist"]
---

# List the Social checklist with this workspace's status

`GET /social/checklist/items`

## Request

- Base URL: `https://www.sagaris.ai/api/v1`
- URL: `https://www.sagaris.ai/api/v1/social/checklist/items`
- Auth: HTTP bearer

Every Social checklist catalog item with the status recorded for the key's workspace, its evidence, its frequency and next due date, its assessed state (assessment: done, missing, unknown or not_applicable, with the evidence or the reason and its sources; a person's recorded status always wins), its executor record (evidence verdict, the person's action, exceptions, priority, dependencies, runner), any approval card waiting on it or a change a person asked for, and what an assistant may do with it (agent.can_record_evidence, agent.accepts_output_kinds). Read only. Requires the social_checklist.read scope.

## Query parameters

- `kind` 'one_time' | 'ongoing'
- `frequency` 'once' | 'daily' | 'with_every_post' | 'weekly' | 'monthly' | 'every_3_months' | 'every_6_months' | 'yearly' | 'as_needed'
- `status` 'not_assessed' | 'not_started' | 'in_progress' | 'done' | 'blocked' | 'not_applicable'
- `limit` integer
- `offset` integer

## Response `200`

A page of checklist items.

- object
  - `data` SocialChecklistItem[], required
    - `id` string
    - `kind` 'one_time' | 'ongoing'
    - `frequency` string
    - `frequency_label` string
    - `area` string
    - `task` string
    - `done_when` string, nullable
    - `automation` 'auto' | 'ai_draft_human_approves' | 'notify_human' | 'human_only'
    - `automation_label` string
    - `applies_to` string
    - `platforms` string
    - `status` 'not_assessed' | 'not_started' | 'in_progress' | 'done' | 'blocked' | 'not_applicable'
    - `status_label` string
    - `evidence` string, nullable
    - `last_done_on` string, date, nullable
    - `status_source` 'member' | 'system' | 'agent', nullable
    - `status_updated_at` string, date-time, nullable
    - `due` object
      - `kind` string
      - `label` string
      - `due_on` string, date, nullable
      - `state` 'overdue' | 'due_today' | 'upcoming', nullable
    - `assessment` object, nullable: The item's assessed state (spec F-05): a person's recorded status where there is one, else SAGARIS's weekly baseline assessment from evidence, else unknown with the reason it is not yet assessed here.
      - `state` 'done' | 'missing' | 'unknown' | 'not_applicable'
      - `state_label` string
      - `reason` string: The evidence (done, missing) or the reason (unknown, not applicable).
      - `sources` object[]
        - `kind` string
        - `label` string
        - `url` string, nullable
        - `on` string, date, nullable
      - `by` 'person' | 'sagaris' | 'assistant' | 'catalog'
      - `assessed_on` string, date, nullable
    - `executor` object: The catalog's executor record for the item.
      - `verdict` 'proven' | 'agreed' | 'required' | 'supported' | 'test_first' | 'replaced'
      - `verdict_label` string
      - `verdict_review` 'pending_owner_review', nullable: pending_owner_review: the verdict (test_first or replaced) is the spec's proposal and the owner has not reviewed it yet. Null for a proven, agreed, required or supported item.
      - `is_default` boolean: In the default checklist every workspace runs: a proven, agreed, required or supported verdict, or an item kept in the run while its proposed verdict waits for the owner's review.
      - `person_action` 'none' | 'approve_change_deny'
      - `person_action_label` string
      - `exceptions` string[]
      - `priority` integer
      - `priority_label` string
      - `depends_on` string[]
      - `runner` string, nullable: The runner that executes the item on SAGARIS's schedule; null while none is built. The item is still assessed (assessment).
    - `card` object, nullable: An approval card waiting for a person, or a change a person asked for that no redo has answered.
      - `state` 'pending' | 'change_requested'
      - `card_id` string
      - `revision` integer
      - `change_note` string, nullable
    - `agent` object
      - `can_record_evidence` boolean
      - `accepts_output_kinds` string[]
  - `meta` SocialChecklistListMeta, required
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required
    - `hasMore` boolean, required
    - `catalog_version` string, required
    - `today` string, date, required: The server's calendar day (UTC) due dates are computed from.
    - `approval_cards` 'read' | 'unavailable', required: Whether the approval cards could be read; unavailable where the card table is not migrated.
    - `agent_rule` string, required: The approval rule an assistant works under.
  - `error` unknown, required

## Other responses

- `400`: Invalid JSON body or field validation failure.
- `401`: Missing, malformed, invalid, revoked, or expired API key.
- `403`: The key does not hold the required scope for this operation.
- `429`: Per-key read rate limit exceeded (120 requests / 60s).
- `500`: Query failure.
- `503`: The database / API-keys table is not provisioned.

---

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