List run summary

get

https://one.fracttal.com/hub/api/v1/dags/{dag_id}/stats/

With this endpoint you can get a summary of a DAG's runs within a specific date range, showing how many succeeded, failed, or didn't run per phase.

Authentication

Requires a Bearer OAuth2 token obtained via the client_credentials flow. See Authentication.

Path parameters

Parameter	Type	Required	Description
`dag_id`	string (UUID)	✅	UUID of the DAG in `8-4-4-4-12` format

Query parameters

Parameter	Type	Required	Description
`start_date`	string (YYYY-MM-DD)	✅	Start of the date range (inclusive)
`end_date`	string (YYYY-MM-DD)	✅	End of the date range (inclusive)

Headers

Name	Value
`Authorization`	`Bearer <access_token>`
`Accept`	`application/json`

Request example

GET /hub/api/v1/dags/589b6c65-1ce9-4a46-9c11-ad380d9bf27a/stats?start_date=2026-06-01&end_date=2026-06-05
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/json

Successful response — 200

{
  "total_runs": 42,
  "fully_successful": 38,
  "any_phase_failed": 4,
  "extract": { "success": 42, "failed": 0, "not_run": 0 },
  "transform": { "success": 40, "failed": 2, "not_run": 0 },
  "load": { "success": 38, "failed": 4, "not_run": 0 },
  "date_range": { "from": "2026-06-01", "to": "2026-06-05" }
}

Field	Type	Description
`total_runs`	integer	Total runs in the range
`fully_successful`	integer	Runs where all 3 phases succeeded
`any_phase_failed`	integer	Runs where at least one phase failed
`extract`	object	success / failed / not_run distribution for the phase
`transform`	object	success / failed / not_run distribution for the phase
`load`	object	success / failed / not_run distribution for the phase
`date_range`	object	Applied date range (`from` / `to`)

Error codes

Code	Description
`401`	Invalid or expired token
`422`	Invalid date range — check `details[]`
`502`	Error querying statistics

Possible issues

All errors follow the RFC 9457 format with Content-Type: application/problem+json.

`401` — Missing, invalid, or expired token

See Authentication issues.

`422` — Invalid date range

{
  "error_code": "VALIDATION_ERROR",
  "message": "Invalid request parameters",
  "status_code": 422,
  "details": [
    { "field": "start_date", "message": "start_date must be in YYYY-MM-DD format" }
  ]
}

Common causes: dates in the wrong format, or start_date after end_date.

`502` — Error in a dependent service

{
  "error_code": "BACKEND_RPC_ERROR",
  "message": "Upstream service returned an unexpected error",
  "status_code": 502
}

Solution: Retry with exponential backoff.

OpenAPI definition

{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "DAG run statistics"
  },
  "servers": [
    {
      "url": "https://one.fracttal.com/hub/api/v1/dags/{dag_id}/stats"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [],
        "description": "With this endpoint you can get a summary of a DAG's runs within a specific date range, showing how many succeeded, failed, or didn't run per phase.",
        "summary": "List run summary",
        "operationId": "get_"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}

Response

200

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here!