Below is a chronological list of changes to our API. Breaking changes will be marked with a red banner.
2026-07-08: Relabeling expected ROI in the show forecast endpoint
This change affects the return of existing endpoints
Previously the v1/clients/{client_slug}/forecasts/{id}Forecaster endpoint returned expected_roi which was labeled Expected Blended ROI in the UI. Expected ROI in the UI is a different value that was not previously returned. The labeling has been corrected so that the field which was previously labeled as expected_roi is now labeled expected_blended_roi. expected_roi has been added as a new field matching the values displayed in UI with the same label. These changes are retroactive and will be visible in all reports regardless of when they were ran.
2026-07-08: Renaming and Relabeling of CPA data in Report endpoints
This change affects the return of existing endpoints
The Reporter endpoints (v1/clients/{client_slug}/reports} when type=”compute_grouped_channel_summaries" previously had downloads with ROI and mROI in the key, even when the model was a CPA model based off conversions. CPA and mCPA numbers were listed under column headers indicating ROI/mROI. These key-names and header rows have been updated to more accurately reflect the data returned when the underlying model is conversion-based. These changes are retroactive and will be visible in all reports regardless of when they were ran.
When type=”compute_spend_summary” the API previously returned columns indicating ROIs for CPA based models by showing total conversions / total spend. The computation and labels have been updated to use CPA labels and show the computation total spend / total conversions. These changes not retroactive and will only apply to reports run after 2026-07-08.