3 Get Results

Step 3: Get Results

Retrieve the processed entity results with completed metrics. Use steps 4aโ€“4d to fetch facilities, plots, and metric data for the full visualization.

What this step does

It reads the task's entities via GET /ingestions/assets/:id, asking for the normalised_data and assessments includes. normalised_data gives you the geocoded, matched fields for each uploaded row (name, country, commodity, coordinates); assessments gives the confidence classification. Together they are the per-entity result set โ€” the "what did my upload turn into" answer that Step 2's status poll only summarised in counts.

Why it's needed

Step 2 tells you the task is completed; this step tells you what completed. The summary endpoint never returns row-level fields, so this is where you actually see the normalised entities and their confidence levels. It's also the anchor for the visualization: the metric endpoints (4c/4d) and the location endpoints (4a/4b) are keyed by the same asset_task_id, and this entity list supplies the names, commodities, and confidence that the metric rows are joined against to build the results table.

Why the include parameter

Without include, the entity list omits the normalised fields and assessments, so the results table would have no name, country, commodity, or confidence columns to fill. Requesting both includes in one call avoids a second round-trip. Drop an include only if you genuinely don't need that slice โ€” e.g. omit assessments when you don't surface confidence.

Request

GET /ingestions/assets/:id?include=normalised_data,assessments

Additional Endpoints for Visualization

StepEndpointData
4aGET /locations/facilities?filter[assets.task_id]=eq:{id}Facility polygons for map
4bGET /locations/plots?filter[assets.task_id]=eq:{id}Plot polygons for map
4cGET /metrics/sheds/deforestation?filter[assets.task_id]=eq:{id}Deforestation metrics
4dGET /metrics/sheds/emissions?filter[assets.task_id]=eq:{id}Emissions metrics

Combined Assets Table

ColumnSource
Namenormalised_data.normalized_name
Locationnormalised_data.normalized_country + lat/lng
Commoditynormalised_data.commodity_type
Confidenceassessments.core.confidence_level
Deforestation Risknoncompliance_area / area from deforestation metrics
Forest Area (ha)forest_area from deforestation metrics
LUC Emissionsluc from emissions metrics
Non-LUC Emissionsnonluc from emissions metrics

Next Step

โ†’ Step 4: Combined Visualization (chains 4aโ€“4d automatically)