Skip to content
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

json
json
{
  "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.

FieldTypeRequiredDescription
tasksarray<unknown>RequiredList of tasks in the schedule
tasks[].idstringRequiredUnique task identifier
include_detailsbooleanOptionalInclude detailed task-level diagnostics and actionable recommendations
use_ml_scoringbooleanOptionalUse ML ensemble model for score aggregation with SHAP explainability (Professional+ tiers only)

Response example

json
json
{
  "score": 92,
  "grade": "A"
}

Response fields from OpenAPI contract

This table is generated from the endpoint response schema in openapi.json.

FieldTypeRequiredDescription
statusstringRequiredTop-level result status — always present in every response.
metadataobjectRequiredAudit trail and processing context — always present, never null.
metadata.task_countintegerRequiredNumber of tasks in the submitted schedule
metadata.endpointstringRequiredEndpoint 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

TermsPrivacyContact

Schedule analysis guidance. Not legal advice. You remain responsible for contract and agency compliance.