Skip to content
Breesy Documentation

Marketing API Overview

The Marketing reporting API gives partner platforms access to the same rolled-up reporting totals shown in Breesy’s paid call attribution reporting.

This API is designed for partner integrations that need summarized reporting data without exposing call-level records or internal matching details.

What The API Returns

The API returns the final report-level totals for a selected date range:

  • Summary metrics like ad spend, paid media calls, matched calls, phone match rate, won collected, open pipeline, lost job estimate, total pipeline, and ROAS/ROI values
  • Market breakdown totals
  • Jobs lost reason buckets
  • Unmatched call buckets and counts

Query Scope

Every summary request requires:

  • franchise_id
  • start_date
  • end_date

The caller can optionally add:

  • location_id
  • campaign
  • market

Lookup Endpoints

The API also provides franchise-scoped lookup endpoints so the client can build valid filter values before requesting the summary:

  • marketing-report-locations
  • marketing-report-filters

Data Shape

The API is intended to return the same net totals the final report would show, not the raw attribution data pipeline.