API Documentation

Example Request

curl -X POST http://localhost:8000/api/v1/checks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The quick brown fox jumps over the lazy dog..."
  }'

Example Response

{
  "id": "chk_abc123",
  "status": "processing",
  "created_at": "2026-03-02T10:30:00Z"
}

// After polling:
{
  "id": "chk_abc123",
  "status": "completed",
  "plagiarism_score": 0.12,
  "ai_score": 0.87,
  "word_count": 150,
  "ai_model_scores": [
    { "model_name": "transformer", "score": 0.91, "label": "AI Generated" },
    { "model_name": "perplexity", "score": 0.85, "label": "AI Generated" },
    { "model_name": "stylometric", "score": 0.82, "label": "AI Generated" },
    { "model_name": "embedding", "score": 0.89, "label": "AI Generated" }
  ],
  "ai_sentences": [
    { "text": "The quick brown fox...", "score": 0.92, "start": 0, "end": 24 }
  ],
  "plagiarism_sources": [
    { "url": "https://example.com", "title": "Example", "similarity": 0.15, "matched_text": "..." }
  ]
}

All API requests require authentication via a Bearer token. You can use either a JWT access token (from login) or an API key (from the dashboard).

Authorization: Bearer your_token_here