Job Status & Management

GET /jobs/{job_id}

Get Job

cURL

curl --request GET \
  --url https://eomer-api-cgeu.onrender.com/jobs/{job_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "job_id": "<string>",
  "status": "pending",
  "created_at": "2023-11-07T05:31:56Z",
  "job_type": "forecast",
  "completed_at": "2023-11-07T05:31:56Z",
  "elapsed_seconds": 123,
  "num_items": 123,
  "prediction_length": 123,
  "error": "<string>",
  "error_code": "validation_error",
  "download_url": "<string>",
  "report_url": "<string>",
  "external_covariate_metadata": {},
  "explainability": {
    "enabled": false,
    "overview_markdown": "",
    "selected_analyses": [
      "<string>"
    ],
    "completed_analyses": [
      "<string>"
    ],
    "skipped_analyses": {},
    "warnings": [
      "<string>"
    ],
    "artifacts": [
      {
        "artifact_id": "<string>",
        "analysis": "<string>",
        "label": "<string>",
        "format": "<string>",
        "output_path": "<string>",
        "download_url": "<string>",
        "embed_url": "<string>",
        "description": "",
        "render_inline": false,
        "preview_markdown": "",
        "highlights": [
          "<string>"
        ],
        "display_order": 0,
        "is_primary_visual": false,
        "is_thumbnail": false
      }
    ],
    "summary_path": "<string>"
  },
  "explainability_url": "<string>",
  "forecast_plot_url": "<string>",
  "reconciliation": {},
  "timings": {},
  "explanation": {
    "headline": "",
    "narrative": "",
    "data_findings": [
      "<string>"
    ],
    "forecast_summary": [
      "<string>"
    ],
    "operational_implications": [
      "<string>"
    ],
    "caveats": [
      "<string>"
    ],
    "confidence": 0,
    "generated_by": "rules"
  },
  "request_id": "<string>",
  "config_hash": "<string>",
  "dataset_hash": "<string>",
  "model_version": "<string>",
  "delivery_status": "<string>",
  "delivery_connection_id": "<string>",
  "delivery_uri": "<string>",
  "delivery_error": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

job_id · string · required

Response

200

application/json

Successful Response

JobResponse

TabularJobResponse

Response model for job status queries.

job_id · string · required

status · enum<string> · required

Status values for async forecast jobs.

Available options: pending, running, completed, failed

created_at · string<date-time> · required

job_type · string · default: forecast

Kind of job: forecast, classification, regression, fine_tune, analysis (sandbox jobs use a sandbox_ prefix). Use it to pick the response shape.

completed_at · string<date-time> | null

elapsed_seconds · number | null

num_items · integer | null

prediction_length · integer | null

error · string | null

error_code · enum<string> | null

Machine-readable error codes for agent-friendly error handling.

Available options: validation_error, invalid_preset, file_too_large, dataset_too_large, rate_limited, server_overloaded, job_not_found, job_not_completed, auth_failed, internal_error, timeout, pipeline_failed, invalid_forecast, idempotency_conflict, storage_error, gpu_offload_unavailable, compute_unavailable, tabular_runtime_unavailable, fine_tune_disabled, connection_not_found, connector_error, sandbox_domain_used, sandbox_captcha_failed, sandbox_dataset_too_large, sandbox_corporate_email_required

download_url · string | null

report_url · string | null

external_covariate_metadata · External Covariate Metadata · object | null

explainability · ExplainabilitySummaryResponse · object | null

Explainability execution status for a forecast job.

Show child attributes

explainability_url · string | null

forecast_plot_url · string | null

reconciliation · Reconciliation · object | null

timings · Timings · object | null

Forecast pipeline wall time by stage, in seconds.

Show child attributes

explanation · ExplanationResponse · object | null

Post-forecast business explanation surfaced on a completed job. Written by the explanation agent (the second LLM in the agentic "sandwich"). Always vendor-neutral — the backend sanitizes every field before persisting, so no underlying model/vendor name appears here.

Show child attributes

request_id · string | null

config_hash · string | null

dataset_hash · string | null

model_version · string | null

delivery_status · string | null

delivery_connection_id · string | null

delivery_uri · string | null

delivery_error · string | null