Response Format

{
  "job_id": "97ba5215-2367-47f8-9298-da43c0722d20",
  "status": "completed",
  "progress": "Classification completed",
  "error": null,
  "result": {
    "success": true,
    "classification": "Invoice",
    "confidence": 0.9999994487765023,
    "total_pages": 1,
    "processed_pages": 1,
    "page_results": [
      {
        "page": 1,
        "success": true,
        "classification": "Invoice",
        "raw_result": "Invoice",
        "confidence": 0.9999994487765023
      }
    ]
  }
}

​

Top-Level Fields

• job_id: unique identifier for the classification job
• status: job state (completed, failed, or an in-progress value such as processing)
• progress: human-readable progress message
• error: error message if the job failed, otherwise null
• result: the classification result object (described below)

​

Result Object

• success: whether the classification operation succeeded
• classification: the overall predicted category for the document
• confidence: confidence score for the overall classification (0–1)
• total_pages: total number of pages in the document
• processed_pages: number of pages successfully processed
• page_results: per-page classifications (described below)

​

Page Result Object

• page: page number, 1-indexed
• success: whether classification succeeded for that page
• classification: the predicted category for the page
• raw_result: the model’s raw output before normalization to a category name; usually identical to classification
• confidence: confidence score for the page’s classification (0–1)

​

Other Job States

{
  "job_id": "660e8400-e29b-41d4-a716-446655440001",
  "status": "processing",
  "message": "Classification started",
  "quota_remaining": 400
}

{
  "job_id": "660e8400-e29b-41d4-a716-446655440001",
  "status": "processing",
  "progress": "Analyzing document...",
  "error": null
}

{
  "job_id": "660e8400-e29b-41d4-a716-446655440001",
  "status": "failed",
  "progress": "Classification failed",
  "error": "Invalid PDF format"
}