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_statusto show processing progress- Progress % =
completed / totalร 100
- Progress % =
- 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)