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. Optional call-detail endpoints are available when an integration needs TapClicks call IDs and lead-level values.

Base URL

Use the Breesy API domain for all Marketing API requests:

https://api.breesy.app

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, total collected revenue, total invoiced revenue, open pipeline, lost job estimate, total pipeline, and ROAS/ROI values
  • Market breakdown totals
  • Projected pipeline metrics that combine actual total pipeline with valid scored leads that do not yet have a Dash estimate
  • Jobs lost reason buckets
  • Unmatched call buckets and counts
  • Optional call-level records grouped by market or location, including attributed estimate, collected, and invoiced totals when a call is matched to Dash jobs

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 lookup endpoints so the client can discover granted franchises and build valid filter values before requesting the summary:

  • List Franchises: /marketing/franchises
  • List Locations: /marketing/locations
  • List Filters: /marketing/filters

Data Shape

The summary endpoint keeps its original rolled-up response shape and adds projected pipeline values as additional fields. Call-level records are exposed through separate endpoints so existing summary consumers continue to work.