---
title: "Get Grouped Failed Images"
method: GET
path: "/api/assignment/"
tags: ["Image Assignment"]
---

# Get Grouped Failed Images

`GET /api/assignment/`

## Request

- Base URL: `https://api.avete.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avete.ai/api/assignment/`
- Auth: HTTP bearer

Returns failed images grouped by Category and Violation with nested stats.
Supports optional filters as a multiselect list (statuses and risk levels).
Company admins can optionally filter by site_id.
Supports cursor/limit for guideline infinite scroll and page/page_size for date/upload modes.
Returns a maximum of 4 images per violation for efficiency.

## Query parameters

- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `scenario_key` string, nullable: Exact scenario identity for date-grouped history
- `filters` string[], nullable
- `type` string, nullable: Media type filter: image | video | longform_video | all
- `group_by` string: Grouping mode: 'guideline', 'date', or 'upload'
- `site_id` integer, nullable: Filter by site (for company_admin)
- `page` integer: Page number (1-indexed)
- `page_size` integer: Items per page
- `cursor` integer, nullable: Infinite-scroll cursor offset for guideline grouping
- `limit` integer, nullable: Infinite-scroll batch size for guideline grouping
- `preview_category_limit` integer, nullable: Only include signed preview images for the first N category groups

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/avete/apis/fastcognito.md) - [All operations](https://skmtc.dev/avete/apis/fastcognito/llms.txt) - [OpenAPI document](https://skmtc.dev/avete/apis/fastcognito/revisions/2c3bbf575ddb?raw)