--- title: "List documents in group folder" method: GET path: "/api/v1/groups/documents/{id}/folders/{folderId}/" tags: ["Folders"] --- # List documents in group folder `GET /api/v1/groups/documents/{id}/folders/{folderId}/` Return plagiarism and AI check documents in a group folder. ## Path parameters - `id` integer, required - `folderId` integer, required ## Query parameters - `page` integer - `size` integer ## Response `200` The request succeeded and returned a paginated list of plagiarism and AI check documents. - object - `success` boolean - `data` object - `documents` union[] - union - Text — Metadata for a submitted plagiarism check. - `id` integer, required — Numeric text check ID. - `version` integer, nullable — Internal text/report format version, when available. - `user_id` integer — Creator user ID. Returned by create/status responses that do not embed the full creator object. - `filename` string, required — Original or generated file name for the submitted text. - `created_at` integer, required — Unix timestamp in milliseconds. - `updated_at` integer, required — Unix timestamp in milliseconds. - `submitted_at` integer, nullable, required — Unix timestamp in milliseconds. - `is_deleted` boolean — Whether the text was marked as deleted. - `deleted_at` integer, nullable — Deletion timestamp in milliseconds, or `null` when the text is active. - `state` 2 | 3 | 4 | 5 — | ID | Name | Description | |---:|:-------|:------------| |2 | STATE_STORED | Text has been stored and is waiting to be submitted to the checking service. | |3 | STATE_SUBMITTED | Text has been submitted to the checking service and is being processed.| |4 | STATE_FAILED | Text has not been checked. An error happened.| |5 | STATE_CHECKED | Text has been successfully checked and you can receive the report.| - `language` string, required — Detected or submitted language code for the document. - `pages` integer, required — Estimated page count used for billing and limits. - `words` integer, required — Number of words detected in the submitted text. - `group_id` integer, nullable — Group associated with the check, or `null` for an individual check. - `custom_author` string, nullable — Custom author display name saved for group checks. - `report_id` integer, nullable — Report ID when the check has a plagiarism report. - `ai_report_id` integer, nullable — AI report ID when an AI report is associated with this text. - `creator` User — User account summary. - `id` integer — Numeric user ID. - `name` string — User display name. - `email` string, email — User email address. - `created_at` integer — User creation timestamp in milliseconds. - `updated_at` integer — User update timestamp in milliseconds. - `is_blocked` boolean — Whether the user account is blocked. - `allowed_languages` string[] — Language codes the user can submit for checking. - `balance` Account — Balance counters for a user or group account. - … - `balance_type` integer — User billing/balance type. - `avatar` string, nullable — URL of the user avatar image, when available. - `sale_role` integer, nullable — Internal sale role for the user, when assigned. - `ai_checks_enabled` boolean — Whether AI detection checks are enabled for this user. - `is_test` boolean — Whether this is a test account. - `is_guest` boolean — Whether this account is a guest account. - `is_change_password_needed` boolean — Whether the user must change an autogenerated password. - `is_email_verification_needed` boolean — Whether this user should complete email verification. - `orders` integer — Number of paid orders for the user. - `not_ai_orders` integer — Number of paid non-AI orders for the user. - `last_ai_order_paid_days_ago` integer, nullable — Days since the user's most recent paid AI order, or `null`. - `report` object, nullable — Plagiarism report summary, or `null` while the text is not checked. - `id` integer — Numeric report ID. - `created_at` string — Report creation timestamp in milliseconds. - `source_count` integer — Number of matched sources in the report. - `percent` string — Similarity percentage for this report. - `ai_report` AiCheck — AI-generated text detection report. - `enabled` boolean — Whether AI detection is enabled for this report/user context. - `id` integer, nullable — Numeric AI report ID, or `null` when a text has no AI report yet. - `status` 1 | 2 | 3 | 4 | 5 | 7 | 8 | 9 | 10, nullable — | ID | Name | Description | |---:|:-------|:------------| | 1 | STATUS_QUEUED | Check in queue | | 2 | STATUS_IN_PROGRESS | Check in progress | | 3 | STATUS_FAILED | Check failed | | 4 | STATUS_CHECKED | Successfully checked | | 5 | STATUS_NOT_ENOUGH_TEXT | Not enough text | | 7 | STATUS_NOT_ENOUGH_ORIGINAL_TEXT | Not enough text | | 8 | STATUS_TEXT_TOO_LONG | Text is too long| | 9 | STATUS_LANGUAGE_IS_NOT_SUPPORTED | Text language is not supported | | 10 | STATUS_CREATED | Check created | - `percent` number, nullable — Overall probability that the submitted text was AI-generated. - `processed_percent` number, nullable — Percentage of the submitted text classified as AI-generated. - `strong_percent` number, nullable — Percentage of the submitted text classified as strongly likely to be AI-generated. - `likely_percent` number, nullable — Percentage of the submitted text classified as likely to be AI-generated. - `mark` 0 | 1, nullable — User feedback for the AI result: `1` means like, `0` means dislike, `null` means not rated. - `comment` string, nullable — Optional user comment submitted with the AI result rating. - `comment_author` object, nullable — User who submitted the rating comment, or `null` when no feedback exists. - … - `type` integer, nullable — AI report type. For ChatGPT/perplexity checks this value is `3`. - `words` integer, nullable — Word count calculated for the AI detection check. - `pages` integer, nullable — Page count calculated for the AI detection check. - `parameters` object — Detector parameters saved with the AI report, when present. - `group_id` integer, nullable — Group ID associated with the AI check, or `null` for an individual check. - `creator` User — User account summary. - … - `has_own_content` boolean, nullable — Whether the report stores its own submitted content. - `conclusion_type` integer, nullable — Numeric conclusion category calculated for checked AI reports. - `conclusion` string, nullable — Human-readable conclusion calculated for checked AI reports. - `content` string, nullable — Original text content used for the AI detection check, when exposed by the endpoint. - `chunks` object[], nullable — Text ranges classified by the AI detector. - … - `ignored_ranges` TextIgnoredRange[] — Character ranges forced to "not AI generated" because they match assignment ignore templates. Chunks overlapping these ranges are trimmed, split, or removed before the AI percentages are calculated. The submitted text itself is never modified. - … - `integration_links` object[] — Integration metadata for texts created through LMS or site integrations. Present only when integration links exist. - AiCheck — AI-generated text detection report. - `enabled` boolean — Whether AI detection is enabled for this report/user context. - `id` integer, nullable — Numeric AI report ID, or `null` when a text has no AI report yet. - `status` 1 | 2 | 3 | 4 | 5 | 7 | 8 | 9 | 10, nullable — | ID | Name | Description | |---:|:-------|:------------| | 1 | STATUS_QUEUED | Check in queue | | 2 | STATUS_IN_PROGRESS | Check in progress | | 3 | STATUS_FAILED | Check failed | | 4 | STATUS_CHECKED | Successfully checked | | 5 | STATUS_NOT_ENOUGH_TEXT | Not enough text | | 7 | STATUS_NOT_ENOUGH_ORIGINAL_TEXT | Not enough text | | 8 | STATUS_TEXT_TOO_LONG | Text is too long| | 9 | STATUS_LANGUAGE_IS_NOT_SUPPORTED | Text language is not supported | | 10 | STATUS_CREATED | Check created | - `percent` number, nullable — Overall probability that the submitted text was AI-generated. - `processed_percent` number, nullable — Percentage of the submitted text classified as AI-generated. - `strong_percent` number, nullable — Percentage of the submitted text classified as strongly likely to be AI-generated. - `likely_percent` number, nullable — Percentage of the submitted text classified as likely to be AI-generated. - `mark` 0 | 1, nullable — User feedback for the AI result: `1` means like, `0` means dislike, `null` means not rated. - `comment` string, nullable — Optional user comment submitted with the AI result rating. - `comment_author` object, nullable — User who submitted the rating comment, or `null` when no feedback exists. - `id` integer — Numeric user ID of the check author. - `name` string — Display name of the check author. - `type` integer, nullable — AI report type. For ChatGPT/perplexity checks this value is `3`. - `words` integer, nullable — Word count calculated for the AI detection check. - `pages` integer, nullable — Page count calculated for the AI detection check. - `parameters` object — Detector parameters saved with the AI report, when present. - `group_id` integer, nullable — Group ID associated with the AI check, or `null` for an individual check. - `creator` User — User account summary. - `id` integer — Numeric user ID. - `name` string — User display name. - `email` string, email — User email address. - `created_at` integer — User creation timestamp in milliseconds. - `updated_at` integer — User update timestamp in milliseconds. - `is_blocked` boolean — Whether the user account is blocked. - `allowed_languages` string[] — Language codes the user can submit for checking. - `balance` Account — Balance counters for a user or group account. - … - `balance_type` integer — User billing/balance type. - `avatar` string, nullable — URL of the user avatar image, when available. - `sale_role` integer, nullable — Internal sale role for the user, when assigned. - `ai_checks_enabled` boolean — Whether AI detection checks are enabled for this user. - `is_test` boolean — Whether this is a test account. - `is_guest` boolean — Whether this account is a guest account. - `is_change_password_needed` boolean — Whether the user must change an autogenerated password. - `is_email_verification_needed` boolean — Whether this user should complete email verification. - `orders` integer — Number of paid orders for the user. - `not_ai_orders` integer — Number of paid non-AI orders for the user. - `last_ai_order_paid_days_ago` integer, nullable — Days since the user's most recent paid AI order, or `null`. - `has_own_content` boolean, nullable — Whether the report stores its own submitted content. - `conclusion_type` integer, nullable — Numeric conclusion category calculated for checked AI reports. - `conclusion` string, nullable — Human-readable conclusion calculated for checked AI reports. - `content` string, nullable — Original text content used for the AI detection check, when exposed by the endpoint. - `chunks` object[], nullable — Text ranges classified by the AI detector. - `reliability` integer — | ID | Name | Description | |---:|:-------|:------------| | 1 | RELIABILITY_LIKELY | Sentence with a small reliability | | 2 | RELIABILITY_STRONG | Sentence with a big reliability | - `position` integer[] — Start and end character offsets for the AI-highlighted text fragment. - `ignored_ranges` TextIgnoredRange[] — Character ranges forced to "not AI generated" because they match assignment ignore templates. Chunks overlapping these ranges are trimmed, split, or removed before the AI percentages are calculated. The submitted text itself is never modified. - `id` integer, nullable — Internal ignored range identifier. - `start` integer — Start character offset of the ignored range. - `end` integer — End character offset of the ignored range. - `filename` string — Name of the ignore assignment template file that produced this range. - `ignore_assignment_template_id` integer, nullable — Identifier of the ignore assignment template that produced this range. - `pagination` Pagination — Pagination metadata returned by list endpoints. - `last` integer — Last available page number. - `current` integer — Current page number. - `num_items_per_page` integer — Requested page size. - `first` integer — First available page number. - `page_count` integer — Total number of pages. - `total_count` integer — Total number of items across all pages. - `page_range` integer — Number of page links included in the current range. - `start_page` integer — First page number in the displayed range. - `end_page` integer — Last page number in the displayed range. - `first_page_in_range` integer — First page number available in the current range. - `lastPage_in_range` integer — Last page number available in the current range. - `current_item_count` integer — Number of items returned on the current page. - `first_item_number` integer — One-based index of the first item on the current page. - `last_item_number` integer — One-based index of the last item on the current page. ## Other responses - `400` — The request is invalid. Check required fields, field formats, and resource ownership. - `403` — Authentication or authorization failed because the token is missing, invalid, blocked, or not allowed to access the resource. --- [API](https://skmtc.net/plagiarismcheck/apis/plagiarismcheck-org-api.md) · [All operations](https://skmtc.net/plagiarismcheck/apis/plagiarismcheck-org-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plagiarismcheck/plagiarismcheck-org-api/versions/034b4999350e/schema)