API ReferenceDashboardMetrics

Metrics

GET /api/v1/dashboard/metrics/

Returns aggregated metrics for your organization, including document counts, job statuses, migration totals, and average confidence scores.

Authentication

Requires an API key with jobs:read scope. Pass via the X-API-Key header.

Response

Status: 200 OK

{
  "total_documents": 142,
  "total_jobs": 138,
  "jobs_by_status": {
    "completed": 130,
    "failed": 5,
    "pending": 2,
    "processing": 1
  },
  "total_migrations": 12,
  "avg_confidence_score": 0.94
}

Response Fields

FieldTypeDescription
total_documentsintegerTotal number of documents uploaded by the organization.
total_jobsintegerTotal number of extraction jobs created.
jobs_by_statusobjectBreakdown of jobs by their current status.
jobs_by_status.completedintegerNumber of successfully completed jobs.
jobs_by_status.failedintegerNumber of failed jobs.
jobs_by_status.pendingintegerNumber of jobs waiting to be processed.
jobs_by_status.processingintegerNumber of jobs currently being processed.
total_migrationsintegerTotal number of payroll migrations.
avg_confidence_scorenumberAverage confidence score across all completed extraction results (0.0 to 1.0).

Errors

StatusDescription
401Missing or invalid API key.
403API key does not have jobs:read scope.

Code Examples

curl https://api.parsifyhq.com/api/v1/dashboard/metrics/ \
  -H "X-API-Key: YOUR_API_KEY"