POST/api/v1/health/score
Calculate Schedule Health Score
Calculate comprehensive schedule health score (0-100) based on deterministic analysis.
This endpoint performs:
- DAG construction and validation
- Critical Path Method (CPM) calculation
- Float analysis and erosion detection
- Critical path density evaluation
- Structural integrity assessment
- Weighted composite scoring per DCMA/GAO/AACE standards
Performance Target: Response time <5s for 1,000 tasks (Phase 1A)
Task Limits:
- Synchronous processing: up to 1,000 tasks
- Tier-based limits: Free (500), Professional (5,000), Enterprise (50,000+)
Compliance:
- DCMA 14-Point Assessment
- GAO Schedule Assessment Guide
- AACE RP 92R-19 (Schedule Health Metrics)
- PMBOK 8 Section 4.5
DCMA 14-PointGAO Schedule Assessment GuideAACE RP 92R-19
Request example
jsonjson
{
"tasks": [
{
"id": "T1",
"duration_days": 5
}
]
}Request fields from OpenAPI contract
Required fields and the optional fields that change this call are listed here. The shared task model stays on the task schema guide.This table is generated from the endpoint schema in openapi.json.
| Field | Type | Required | Description |
|---|---|---|---|
| tasks | array<unknown> | Required | List of tasks in the schedule |
| tasks[].id | string | Required | Unique task identifier |
| include_details | boolean | Optional | Include detailed task-level diagnostics and actionable recommendations |
| use_ml_scoring | boolean | Optional | Use ML ensemble model for score aggregation with SHAP explainability (Professional+ tiers only) |
Response example
jsonjson
{
"score": 92,
"grade": "A"
}Response fields from OpenAPI contract
This table is generated from the endpoint response schema in openapi.json.
| Field | Type | Required | Description |
|---|---|---|---|
| status | string | Required | Top-level result status — always present in every response. |
| metadata | object | Required | Audit trail and processing context — always present, never null. |
| metadata.task_count | integer | Required | Number of tasks in the submitted schedule |
| metadata.endpoint | string | Required | Endpoint path e.g. /api/v1/health/score |
Schema
json-schema
{
"$ref": "#/components/schemas/BellatorResponse_HealthScoreData_"
}Authentication
- API key required
- x-api-key header
Reference details
- Operation ID
- calculate_health_score_api_v1_health_score_post
- Section
- health
- Tags
- health
- Playground link
- /playground?endpoint=/api/v1/health/score&method=post
Was this page helpful?
Your feedback helps us improve docs, reference pages, and Playground flows.
Topic: Calculate Schedule Health Score · Page: /docs/api-reference/calculate_health_score_api_v1_health_score_post