The ILAP Analytics API lets you consume scheduling data — schedules, activities, periodized progress, resources, links, and metadata — for reporting and integration. This overview is for planners and Power BI / report developers, as well as data engineers, and assumes REST/GraphQL basics and that you can obtain a DataReader token.
What data is available
- Schedules & revisions
- Activities (+ periodized planned/earned/actual hours)
- Successors/links
- Resource assignments
- Calendars
- Metadata fields
Tenant-specific extension fields appear dynamically on GraphQL types and are not enumerated here.
Revision types
Live— the current working version of the schedule.Baseline— the version most recently set as the baseline for comparison.OriginalBaseline— the first baseline ever set, preserved for original-plan comparisons.Current— the latest revision regardless of baseline status.
REST export vs GraphQL — when to use which
REST export (/api/v3/export/*) |
GraphQL (/graphql) |
|
|---|---|---|
| Shape | Fixed, tabular, IDE-compatible | You pick exactly the fields |
| Paging | PageNumber + PageSize |
Cursor (first/after) |
| Best for | Full/bulk extracts into a Lakehouse/Warehouse (Fabric) | Targeted, filtered queries & progress summaries (Power BI) |
| Filtering | By ReportScheduleId + RevisionType |
where / order + projection |
The Parquet export — the third route
REST and GraphQL both serve the data that is currently in ILAP Analytics. Where the export is enabled, ILAP Analytics also writes planning and reporting snapshots as Parquet files into a storage account you own, and those snapshots survive the retention purge that eventually removes the rows from the operational database. Successive snapshots of one report schedule are a record of how the plan moved — which no query against live data can reconstruct.
Use it for historical analysis and for lakehouse consumption; use the API for anything about the present. See Parquet export for the layout and contents, and Reading Parquet from Fabric for consuming it. The export is off by default and enabled per deployment.
Authentication
All API calls require a bearer token scoped to the DataReader role. See the Authentication guide for how to request and use one.
Guides
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article