Time Window Service

List all supported time window types

{
  "data": [
    {
      "window": "monthly",
      "label": "This Month",
      "description": "Current calendar month"
    },
    {
      "window": "quarterly",
      "label": "This Quarter",
      "description": "Current calendar quarter"
    },
    {
      "window": "yearly",
      "label": "This Year",
      "description": "Current calendar year"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

Get the resolved date range for a given time window type

{
  "window": "quarterly",
  "start_date": "2026-01-01",
  "end_date": "2026-03-31",
  "resolved_at": "2026-03-26T10:00:00Z"
}

Resolve a date range for a custom or named time window (supports custom anchor date)

{
  "window": "monthly",
  "anchor_date": "2025-11-15"
}

{
  "window": "monthly",
  "start_date": "2025-11-01",
  "end_date": "2025-11-30",
  "resolved_at": "2026-03-26T10:01:00Z"
}

Update the configuration/offset for a time window type

{
  "offset_days": -1,
  "description": "Previous calendar month (offset)"
}

{
  "window": "monthly",
  "offset_days": -1,
  "description": "Previous calendar month (offset)",
  "updated_at": "2026-03-26T10:02:00Z"
}

Remove a custom time window configuration (built-in windows cannot be deleted)

{
  "deleted": true,
  "window": "custom_q1_fy2026"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}