Project burn projection

Returns forward-looking burn projection for a project: contract-by-contract consumed vs. remaining value, a 12-week weekly series, burn status signals, and alerts. Burn is revenue-side (bill rate × hours) to compare against the client-facing contract ceiling. Not a raw data endpoint — designed for dashboards, BI tools, and delivery-risk agents.

GET/api/v1/projects/:id/burn-projection

Authorization

financials:readapi key scoperequired

Required scope when calling with an API key.

project:financial_readsession capabilityoptional

Required capability when calling with a signed-in session.

Path parameters

idstringrequired

Project ID

Example: proj_abc123

Request

GET /api/v1/projects/:id/burn-projection

curl -X GET "https://www.digitalstack360.com/api/v1/projects/proj_abc123/burn-projection" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "project_id": "proj_abc123",
    "project_name": "Website Replatform",
    "scope": "project",
    "contracts": [
      {
        "contract_id": "ctr_xyz789",
        "contract_name": "Phase 1 SOW",
        "contract_value": 450000,
        "consumed_value": 182500,
        "remaining_value": 267500,
        "projected_completion_cost": 411000,
        "projected_overrun": 0,
        "burn_status": "on_track",
        "attributed_entries": true,
        "status": "active"
      }
    ],
    "summary": {
      "total_contract_value": 450000,
      "total_consumed_value": 182500,
      "total_remaining_value": 267500,
      "weekly_burn_rate": 21400,
      "projected_completion_cost": 411000,
      "projected_overrun": 0,
      "weeks_until_budget_exhausted": 12.5,
      "burn_status": "on_track",
      "unattributed_cost": 0
    },
    "projection": {
      "window_weeks": 12,
      "confidence": 0.85,
      "method": "recent_burn_rate",
      "weekly": [
        {
          "week_start": "2026-05-17",
          "projected_consumed_value": 203900,
          "projected_remaining_value": 246100
        }
      ]
    },
    "alerts": [],
    "updated_at": "2026-05-13T09:00:00.000Z"
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks financials:read scope

404

not_found

Project not found or not in your workspace