Workforce Engagement Management

 View Only

Sign Up

Back to discussions
Expand all | Collapse all

Main Forecast Export APIs : Export Continuous Forecasts, Snapshots, and Historical Actuals

  • 1.  Main Forecast Export APIs : Export Continuous Forecasts, Snapshots, and Historical Actuals

    Posted yesterday
    Edited by Pavithra Asokan 7 hours ago

    🚀 New Feature: Main Forecast Export APIs 


    Many customers need to take Main Forecast data out of Genesys Cloud to:

    • Compare forecast vs actuals

    • Reconcile performance

    • Run deeper analysis in external BI tools or data warehouses

    With this release, you can now do that directly via API. We've introduced Main Forecast Export APIs , which let you export Continuous Forecast data, forecast snapshots, and historical actuals from Main Forecast as CSV files-ready for downstream processing.

    🗓️ Availability is targeted for March 16th, 2026.

    📦What's Included

    1. Export Continuous Forecasts

    Export aggregated Continuous Forecast values for the date range you specify.

    • Supports extended date ranges (up to the Continuous Forecast limits defined for Main Forecast)

    • Ideal for long‑range planning and external modeling

     

    2. Export Historical Actuals

    Export aggregated historical actuals for the date range you specify.

    • Excludes the current planning week

    • Use for comparing forecast vs. actuals outside Genesys Cloud

    3. Export Forecast Snapshots

    • Exports one snapshot per request, and the specific snapshot must be explicitly specified.

     

    🛠️ Key Capabilities

    Flexible filtering

    1. Provide start and end dates to control the time window
    2. If the requested dates fall outside the data range, the response is truncated to available data
    3. Choose granularity: 15 minutes, 30 minutes, 60 minutes, day, or week
    4. Specify a time zone (defaults to the Business Unit time zone)– time zone shifts are applied after aggregation

     

    Customizable output

    1. Choose your delimiter (comma by default; any single character allowed) for easier ingestion into databases, BI tools, and custom pipelines
    2. Output is a single file

      

    đź”— Endpoints to submit an export job

    1. Forecast Export : /api/v2/workforcemanagement/businessunits/{businessUnitId}/mainforecast/continuousforecast/session/export/forecast/jobs

    2. Historical Export: /api/v2/workforcemanagement/businessunits/{{BusinessUnitId}}/mainforecast/continuousforecast/session/export/historical/jobs

    3. Snapshot Export: /api/v2/workforcemanagement/businessunits/{{BusinessUnitId}}/mainforecast/continuousforecast/session/export/snapshot/jobs

    ⚠️ Important Notes & Constraints

    Single planning group
    If only one planning group is provided, no aggregation is applied. The data reflects that planning group as is.

    Large exports
    If the dataset exceeds what's practical for your specific use case, consider the following options:

    • Reduce the date range

    • Change granularity

    • For snapshot exports, limit the number of snapshots

    DST behavior
    During Daylight Saving Time transitions, you may see duplicate or missing intervals.

    Start integrating Main Forecast Export APIs into your reporting and planning workflows.


    #Forecasting

    ------------------------------
    Pavithra Asokan
    Staff Product Manager, WEM
    ------------------------------



Related Content