Jobs

Get Job Status

Poll async job status and retrieve result when completed.

This unified endpoint serves all async operations including:

  • Health score calculations
  • Forensics analysis (logic audit, DCMA 14-point, etc.)
  • CPM calculations
  • Resource analysis
  • And all other async endpoints

Job Lifecycle:

  1. queued - Job submitted, waiting for worker
  2. processing - Worker executing job
  3. completed - Job finished successfully, result available
  4. failed - Job encountered error
  5. cancelled - Job cancelled by user

Progress Tracking:

  • progress_percent: Overall progress (0-100)
  • checks_completed / total_checks: Granular progress for forensics endpoints

Polling Recommendations:

  • Initial delay: 5 seconds
  • Interval: 2-5 seconds
  • Exponential backoff for long-running jobs

Result Expiration:

  • Job results are stored for 24 hours
  • After expiration, job status returns 404
get/api/v1/jobs/{job_id}

Request

  • Base URL: https://api.bellatorsi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.bellatorsi.com/api/v1/jobs/{job_id}
  • Auth: none declared

Path parameters

job_idstring required

Headers

x-api-keystring nullable
authorizationstring nullable
x-bellator-internal-dispatchstring nullable

Response

Success - Job status retrieved

job_idstring required

Job identifier

status'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' required

Status of an async job.

Job lifecycle:

  1. QUEUED - Job submitted to queue, waiting for worker
  2. PROCESSING - Worker picked up job and is executing
  3. COMPLETED - Job finished successfully
  4. FAILED - Job encountered an error
  5. CANCELLED - Job was cancelled by user before completion
created_atstring date-time required

Job creation timestamp

started_atstring date-time nullable

Job start timestamp

completed_atstring date-time nullable

Job completion timestamp

task_countinteger required

Number of tasks in schedule

resultobject nullable

Job result when completed

errorstring nullable

Error message if failed

progress_percentnumber nullable

Job progress percentage (if available)

endpoint_namestring nullable

Endpoint that submitted this job

checks_completedinteger nullable

Number of checks/steps completed (for forensics endpoints)

total_checksinteger nullable

Total number of checks/steps (for forensics endpoints)

Example response

{
  "completed_at": "2025-01-08T12:00:20Z",
  "created_at": "2025-01-08T12:00:00Z",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "progress_percent": 100,
  "result": {
    "breakdown": {},
    "confidence": 0.95,
    "score": 85.5,
    "top_signals": []
  },
  "started_at": "2025-01-08T12:00:05Z",
  "status": "completed",
  "task_count": 5000
}

Changes

No recorded changes to this operation across all 1 revision of this API.