Get Ingestion Summary

Get a summary of an ingestion task including counts of processed entities.

Use Cases

  • Get a quick overview of what an ingestion produced โ€” how many facilities, plots, and sheds were created or matched.
  • Display ingestion results in a dashboard.

Query parameters

  • include=deforestation โ€” opt-in EUDR compliance roll-up. Adds attributes.deforestation to the response with plot counts (total_plots, compliant_plots, non_compliant_plots, unknown_plots) and area totals (total_area_ha, compliant_area_ha). Only meaningful once the task's deforestation processing has completed; unknown include values return 400 VALIDATION_ERROR. See Query Parameters โ€” Per-endpoint includes.

Example with the roll-up attached:

{
  "data": {
    "attributes": {
      "overall_status": "completed",
      ...,
      "deforestation": {
        "total_plots": 120,
        "compliant_plots": 95,
        "non_compliant_plots": 12,
        "unknown_plots": 13,
        "total_area_ha": 2410.5,
        "compliant_area_ha": 1980.2
      }
    }
  }
}

Required scope: ingestions:read