Skip to main content
GET
/
v1
/
stats
/
jobs
Get job stats over time
curl --request GET \
  --url http://localhost:8000/v1/stats/jobs \
  --header 'Authorization: Bearer <token>'
{
  "period": {
    "start": "<string>",
    "end": "<string>"
  },
  "group_by": "day",
  "data": [
    {
      "date": "<string>",
      "total": 123,
      "by_status": {
        "pending": 0,
        "processing": 0,
        "completed": 0,
        "failed": 0
      },
      "avg_processing_time_seconds": 123,
      "p95_processing_time_seconds": 123
    }
  ],
  "totals": {
    "total": 123,
    "by_status": {
      "pending": 0,
      "processing": 0,
      "completed": 0,
      "failed": 0
    },
    "success_rate": 123,
    "avg_processing_time_seconds": 123
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: dk_test_ or dk_live_

Query Parameters

​
group_by
enum<string>
default:day

Time grouping interval

Available options:
day,
week,
month
​
start_date
string<date> | null

Start date (ISO 8601, default: 30 days ago)

​
end_date
string<date> | null

End date (ISO 8601, default: today)

​
status
enum<string> | null

Filter by job status

Available options:
pending,
processing,
completed,
failed

Response

Job processing metrics and status breakdown over time

Response for job stats over time (GET /v1/stats/jobs).

Job processing metrics and status breakdown over time.

​
period
StatsPeriod · object
required

Time period covered

Example:
{
  "end": "2025-12-07",
  "start": "2025-11-07"
}
​
group_by
enum<string>
required

Grouping interval

Available options:
day,
week,
month
​
data
JobStatsDataPoint · object[]
required

Time series data points

​
totals
JobStatsTotals · object
required

Aggregated totals for the period

Example:
{
  "avg_processing_time_seconds": 11.8,
  "by_status": {
    "completed": 148,
    "failed": 5,
    "pending": 2,
    "processing": 1
  },
  "success_rate": 0.967,
  "total": 156
}