5 Check Processing Status

Step 5: Check Processing Status

Poll the task summary to track deforestation and emissions processing progress. Continue polling until overall_status is completed.

What this step does

Same summary endpoint as Step 2, now pointed at the {{process_task_id}} from Step 4. It reports how the metric run is progressing via by_status and overall_status, which advances staged โ†’ processing โ†’ completed. You poll it every 5โ€“10s until it reads completed.

Why it's needed

Metric processing is asynchronous and can take minutes for large batches, so Step 4 returns immediately without results. The locations and metrics reads in Step 6 only have complete data once every entity has been processed โ€” poll here until completed so you don't read a half-finished batch and render partial or missing metrics. This is the gate between triggering the run and consuming its output.

Request

GET /ingestions/:id/summary

Frontend Usage

  • Progress bar: Use by_status to show processing progress
    • Progress % = completed / total ร— 100
  • Status badge: Show overall_status (pending, staging, staged, processing, completed)
  • Poll interval: Every 5โ€“10 seconds until overall_status === "completed"

Task Status Progression

pending โ†’ staging โ†’ staged โ†’ processing โ†’ completed

Next Step (when completed)

โ†’ Step 6: Get Assets with Metrics (GET /ingestions/assets/:id)