Reports API

Dashboard summaries, trends and distribution data.

The reports endpoints aggregate the workspace into shapes that are ready to chart, so dashboards make one call instead of many.

Dashboard summary

GET/api/reports/dashboard-summary/Auth required

Powers the tenant dashboard: headline metrics, status mix, source mix, a seven-day volume series and recent activity.

Response

FieldTypeDescription
overviewobjectactive_sources, running_pipelines, completed_today, success_rate.
pipeline_statusobjectPercentage share of completed, running, failed and pending.
datasource_typesobjectCount of sources per type, keyed by CSV, JSON and API.
weekly_processing_volumearraySeven entries of { day, processed, errors }.
recent_activityarrayLatest executions with pipeline name, status and timestamp.

Tenant report

GET/api/reports/tenant-reports/?range=30dAuth required

Powers the Reports page with longer-range aggregates.

Query parameters

FieldTypeDescription
rangestringReporting window: `7d`, `30d` or `90d`. Any other value falls back to `7d`. Controls the length of `execution_trends` and is echoed back in the response.

Response

FieldTypeDescription
overviewobjecttotal_records, success_rate, total_pipeline, data_volume_mb.
execution_trendsarrayDaily series of { date, success, failed }.
data_source_distributionarrayPer-source records and volume.
pipeline_performance_summaryarrayPer-pipeline runs, successes, failures and success rate.

Execution history

GET/api/reports/executions/Auth required

Read-only execution records for auditing and external tooling.

Last reviewed October 2026.