Detect plagiarized and similar code across trillions of code sources on the web See what's new
Developer API

Batch Upload

Build plagiarism detection into your apps. Check code against 20+ billion sources.

Documentation Get API Key
const response = await fetch('https://codequiry.com/api/v1/check', { method: 'POST', headers: { 'apikey': 'YOUR_API_KEY' }, body: formData }); // Check created!
BATCH UPLOAD API

Batch Upload Files

Upload multiple ZIP files to a check in a single request. Upload up to 50 files at once, significantly faster than uploading one at a time.

API Endpoint

POST https://codequiry.com/api/v1/check/upload-batch
Performance Tip: Batch upload is significantly faster than making individual upload requests. Use it whenever you have more than 2 files to upload.

Authentication

Include your API key in the request header:

apikey: YOUR_API_KEY_HERE

Request Parameters

Send as multipart/form-data:

Parameter Type Required Description
check_id Integer Required The check ID to upload files to
files[] File[] Required Array of ZIP files (1-50 files, max 10MB each). Each ZIP should contain one student's code submission.
File Requirements: Each file must be a ZIP archive containing source code files. Maximum 50 files per request, 10MB per file.

Success Response

HTTP Status: 200 OK

{
    "success": true,
    "message": "Uploaded 3 file(s) successfully",
    "uploaded": [
        {
            "id": 45001,
            "filename": "student1_submission",
            "file_size": 24576,
            "status_id": 2
        },
        {
            "id": 45002,
            "filename": "student2_submission",
            "file_size": 18432,
            "status_id": 2
        },
        {
            "id": 45003,
            "filename": "student3_submission",
            "file_size": 20480,
            "status_id": 2
        }
    ],
    "uploaded_count": 3,
    "failed_count": 1,
    "failed_uploads": [
        {
            "file": "invalid_file.zip",
            "error": "Invalid or corrupted file"
        }
    ],
    "check": {
        "id": 2810,
        "name": "Python Assignment - Week 5",
        "status_id": 2,
        "course_id": 512,
        "created_at": "2024-01-15 14:30:22",
        "updated_at": "2024-01-15 14:35:10"
    }
}
        

            

                JSON Response
Response Fields
  • success — Boolean indicating the batch upload completed (even if some files failed)
  • message — Confirmation message ("Uploaded {n} file(s) successfully")
  • uploaded — Array of objects for each successfully created submission, each with id, filename (with the .zip extension stripped), file_size (bytes), and status_id
  • uploaded_count — Number of successfully uploaded files
  • failed_count — Number of files that failed to upload
  • failed_uploads — Array of objects describing each failed upload, each with file (the original filename) and error (reason)
  • check — The full updated check (assignment) object as stored, including id, name, status_id, timestamps, and all other model attributes

Error Responses

401 Unauthorized

Invalid or missing API key.

403 Forbidden

Attempting to upload to a demo assignment ("Demo assignments are read-only.").

422 Unprocessable Entity

Validation failure: check_id missing or not an integer; no files supplied; more than 50 files; or any file over 10MB or not a ZIP (mimes:zip). The response includes a validation_errors object. Also returned when the check is not found / not yours ("Invalid check_id provided.") or no API Checks folder exists.

500 Internal Server Error

An unexpected failure occurred during the batch ("Batch upload failed"). Note: individual files that fail are reported per-file in failed_uploads with a 200 response, not a 500.

Code Examples

cURL
curl -X POST "https://codequiry.com/api/v1/check/upload-batch" \
  -H "apikey: YOUR_API_KEY_HERE" \
  -F "check_id=2810" \
  -F "files[][email protected]" \
  -F "files[][email protected]" \
  -F "files[][email protected]"
        

            
cURL
JavaScript
async function batchUpload(checkId, files) {
    const formData = new FormData();
    formData.append('check_id', checkId);

    files.forEach(file => {
        formData.append('files[]', file);
    });

    const response = await fetch('https://codequiry.com/api/v1/check/upload-batch', {
        method: 'POST',
        headers: { 'apikey': 'YOUR_API_KEY_HERE' },
        body: formData
    });

    const data = await response.json();

    if (data.success) {
        console.log(`Uploaded: ${data.uploaded_count} files`);
        if (data.failed_count > 0) {
            console.warn(`Failed: ${data.failed_count} files`);
            data.failed_uploads.forEach(f => {
                console.warn(`  ${f.file}: ${f.error}`);
            });
        }
    }

    return data;
}

// Usage with file input
const fileInput = document.querySelector('input[type="file"]');
await batchUpload(2810, Array.from(fileInput.files));
        

            
JavaScript
Python
import requests
import os
import glob

def batch_upload(check_id, file_paths, api_key):
    """Upload multiple ZIP files to a check."""
    files = []
    for path in file_paths:
        filename = os.path.basename(path)
        files.append(('files[]', (filename, open(path, 'rb'), 'application/zip')))

    response = requests.post(
        'https://codequiry.com/api/v1/check/upload-batch',
        headers={'apikey': api_key},
        data={'check_id': check_id},
        files=files
    )

    data = response.json()
    print(f"Uploaded: {data['uploaded_count']}, Failed: {data['failed_count']}")
    return data

# Upload all ZIP files from a directory
zip_files = glob.glob('/path/to/submissions/*.zip')
result = batch_upload(2810, zip_files, 'YOUR_API_KEY_HERE')
        

            
Python

Best Practices

One Student Per ZIP

Each ZIP file should contain one student's submission. Name ZIPs descriptively (e.g., john_doe.zip).

Batch for Speed

Use batch upload instead of individual uploads when you have more than 2 files. It's significantly faster.

Handle Partial Failures

Check failed_uploads in the response and retry failed files individually if needed.

Optimize File Sizes

Keep each ZIP under 10MB. Remove unnecessary files (node_modules, .git, etc.) before zipping.

What's Next?

Start Analysis

Begin plagiarism detection once all files are uploaded.

Start Check
Single Upload

Upload files one at a time for more granular control.

Single Upload