---
title: "Get Assignment Cards"
method: GET
path: "/api/assignment/cards"
tags: ["Image Assignment"]
---

# Get Assignment Cards

`GET /api/assignment/cards`

## 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/cards`
- Auth: HTTP bearer

Returns a paginated flat card list for the assignment center.

## Query parameters

- `site_id` integer, required: Site ID to fetch assignment cards for
- `status` string: Card status filter: all | open | assigned | resolved
- `type` string: Media type filter: all | image | video | longform_video
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `page` integer: Page number (1-indexed)
- `page_size` integer: Items per page
- `sort` string: Sort order: uploaded_at_desc | uploaded_at_asc

## Response `200`

Successful Response

- AssignmentCardListResponse
  - `items` AssignmentCardItem[], required
    - `card_key` string, required
    - `image_id` integer, nullable
    - `longform_video_id` integer, nullable
    - `ai_report_id` string, nullable
    - `media_type` string, required
    - `thumbnail_url` string, nullable
    - `preview_url` string, nullable
    - `site_id` integer, required
    - `zone_id` integer, nullable
    - `zone_name` string, nullable
    - `uploaded_at` string, date-time, required
    - `uploaded_by` string, nullable
    - `status` string, required
    - `assigned_to_name` string, nullable
    - `assigned_by_name` string, nullable
    - `risk_score` string, nullable
    - `safety_score` integer, nullable
    - `guideline_name` string, nullable
    - `guideline_uuid` string, nullable
    - `violation_frequency` integer, nullable
    - `risk_counts` AssignmentCardRiskCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `scenario_labels` string[]
    - `evidence_count` integer
    - `has_analysis` boolean
    - `analysis_ref` AssignmentCardAnalysisRef
      - `image_id` integer, nullable
      - `longform_video_id` integer, nullable
      - `ai_report_id` string, nullable
      - `guideline_uuid` string, nullable
      - `media_type` string, required
  - `pagination` AssignmentCardPagination, required
    - `page` integer, required
    - `page_size` integer, required
    - `total_items` integer, required
    - `total_pages` integer, required
    - `has_next` boolean, required

## 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)
