Submissions
Upload files, choose report types, and follow job states.
Supported files
- PDF, DOCX, and TXT
- Up to 50 MB per file
- Chinese, English, mixed-language writing, and 30+ Turnitin-supported languages
Report options
Each quote and submission uses report_types: Similarity only, AI only, or both. report_types must not contain duplicates. A quote is frozen for its upload and report set, so do not reuse quote_id for a different request.
Lifecycle
- queued: accepted and waiting for provider capacity
- running: provider execution or report generation is active
- partial_completed: at least one requested report is available
- completed: every requested report is available
- failed: classified error returned with refund behavior for terminal platform failures
Reading reports
GET /v1/submissions/:id/report?type=similarity|ai returns JSON metadata and an optional structured payload. GET /v1/submissions/:id/report/file?type=similarity|ai returns the binary report file, with Content-Type and Content-Disposition describing the artifact. The managed-key surface currently has no submissions list endpoint; follow the links returned by creation and persist your own integration references.