---
title: "List content in the verification workflow"
method: GET
path: "/org/content/verification"
tags: ["Content"]
---

# List content in the verification workflow

`GET /org/content/verification`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/content/verification`
- Auth: API key in header `X-API-Key`

Returns a paginated list of content items in the verification workflow — drafts, rejected, and published — with each item's owners, tags, publish destinations, and citation metrics. Requires the GEO product.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `status` 'all' | 'review' | 'draft' | 'rejected' | 'published'
- `substatus` 'pending_draft'
- `tag_ids` string
- `sort` 'citation_rate_desc' | 'citation_rate_asc' | 'raw_citations_desc' | 'raw_citations_asc'

## Response `200`

One page of verification items.

- ContentVerificationListResponse: A paginated list of content items in the verification workflow.
  - `items` ContentVerificationItemResponse[], required
    - `content_id` string, uuid, required
    - `version_id` string, uuid, required
    - `title` string, required
    - `summary` string
    - `editorial_status` string, required: The editorial workflow state (e.g. `draft`, `published`, `rejected`).
    - `generated_at` string, date-time, required
    - `published_at` string, date-time
    - `ever_published` boolean, required
    - `manually_marked_published` boolean, required: True when the content was recorded as published manually rather than pushed through a destination.
    - `citation_rate` number: **Citation Coverage for this content item, despite the field name** — the name is kept for backward compatibility, but the metric is not a Citation Rate. Numerator: distinct answers to this item's linked prompt, in the last 30 days, that cited one of the item's live published URLs. Denominator: `D` scoped to that prompt — the distinct answers to it in the same 30 days that carried at least one citation of any tier. Both are answer grain, so an answer citing this page three times counts once. Expressed as a percentage on a **0–100** scale, not a 0–1 fraction. Absent when that `D` was zero: not measured, never measured as zero.
    - `raw_citations` integer, required: Citation **instances** (not answers) in the last 30 days pointing at any of this item's live destination URLs, summed across all destinations. Unlike `citation_rate` this is not scoped to the linked prompt, and it is `0` rather than absent when nothing matched.
    - `geo_question_id` string, uuid, required
    - `question_text` string, required
    - `question_type` string, required: The prompt's question type (e.g. `awareness`, `consideration`, `evaluation`, `decision`).
    - `owners` ContentOwnerResponse[], required
      - `user_id` string, uuid, required
      - `email` string, required
      - `given_name` string, required
      - `family_name` string, required
    - `org_tags` TagResponse[], required
      - `id` string, uuid, required
      - `org_id` string, uuid, required
      - `name` string, required
      - `curated` boolean, required: True = part of the org's working vocabulary; false = machine-minted (from search queries), awaiting adoption.
      - `prompt_count` integer: Prompts carrying this tag.
      - `content_count` integer: Content items carrying this tag.
      - `kb_content_count` integer: Knowledge-base nodes carrying this tag.
      - `generated_content_count` integer: Generated content carrying this tag.
      - `generated_draft_count` integer: Generated drafts carrying this tag.
      - `generated_published_count` integer: Published generated content carrying this tag.
      - `kb_search_message_count` integer: Search queries carrying this tag.
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `destinations` PublishDestinationResponse[], required
      - `publish_record_id` string, uuid, required
      - `publisher_id` string, uuid
      - `publisher_name` string, required
      - `publisher_slug` string, required
      - `publisher_type` string, required: The destination's publisher kind: `citeables`, or `manual` for content you published yourself and recorded via manual publish.
      - `publisher_scope` string, required: Whether the destination is shared across the org or org-specific (e.g. `shared`, `org`).
      - `state` string, required: The publish state for this destination (e.g. `live`, `pending`, `failed`).
      - `external_url` string: The published URL, when live.
      - `last_attempt_at` string, date-time
      - `last_error` string: The last publish error, when the most recent attempt failed.
    - `rejection` ContentRejectionResponse: The latest rejection record for a content item's current version (present only on rejected rows).
      - `reason` string
      - `rejected_at` string, date-time
      - `rejected_by` ContentOwnerResponse: A user who owns a content item.
        - `user_id` string, uuid, required
        - `email` string, required
        - `given_name` string, required
        - `family_name` string, required
    - `earliest_publish_at` string, date-time
    - `first_citation_at` string, date-time
    - `days_to_first_citation` integer
  - `total_count` integer, required: Content items matching the filter, across all pages.
  - `draft_count` integer, required: Items whose current version is a draft that has never been published.
  - `rejected_count` integer, required: Items whose current version has been rejected.
  - `pending_published_draft_count` integer, required: Items whose current version is a draft **while a previously published version is still live** — a re-edit in progress, counted as a subset of published rather than of drafts.
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)