---
title: "Accuracy Overview"
method: POST
path: "/v1/reports/accuracy/overview"
tags: ["Reports"]
---

# Accuracy Overview

`POST /v1/reports/accuracy/overview`

## Request body

- AccuracyOverviewQuery
  - `start_date` string, required
  - `end_date` string, required
  - `comparison_start_date` string, nullable
  - `comparison_end_date` string, nullable
  - `category_id` string, uuid, required
  - `topic_ids` string[], nullable
  - `exclude_topic_ids` boolean
  - `tag_ids` string[], nullable
  - `tag_filter_type` 'all' | 'any'
  - `include_no_tag` boolean
  - `region_ids` string[], nullable
  - `platform_ids` string[], nullable
  - `persona_ids` string[], nullable
  - `include_no_persona` boolean
  - `prompt_ids` string[], nullable
  - `citation_categories` string[], nullable
  - `date_bucket` string, nullable
  - `group_by` 'period' | 'theme'

## Response `200`

Successful Response

- AccuracyOverviewResponse
  - `trendByPeriod` AccuracyTrendPoint[], required
    - `date` string, required
    - `total` integer, required
    - `accurate` integer, required
    - `ratio` number, required
    - `prevPeriodData` AccuracyTrendPoint — recursive
  - `overallAccuracy` number, required
  - `accuracyChange` number, nullable
  - `scoreBreakdown` AccuracyScoreBreakdown[], required
    - `status` string, required
    - `count` integer, required
    - `share` number, required
    - `countChange` integer, nullable
    - `shareChange` number, nullable
  - `themeTrend` AccuracyThemeTrendSeries[], nullable
    - `id` string, required
    - `label` string, required
    - `data` AccuracyThemeTrendPoint[], required
      - `date` string, required
      - `total` integer, required
      - `accurate` integer, required
      - `ratio` number, required
  - `availableSeries` AccuracyTrendSeriesMeta[], nullable
    - `id` string, required
    - `label` string, required
    - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.net/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/versions/ab03b3c80494/schema)