Skip to content
Docs

Get Campaign Provider Mix

See how a campaign's sending mailboxes and leads split across Google, Microsoft and other mail providers.

GEThttps://api.foxreach.io/api/v1/campaigns/{campaign_id}/esp-mix

Use this to check whether provider matching (espMatching) has enough of the right mailboxes to work with. The counts come from lookups FoxReach has already stored, so the request is fast and never waits on a lookup. Leads whose provider is not looked up yet are counted as unresolved.

Path Parameters#

campaign_idstringpathrequired

The unique identifier of the campaign.

Response#

dataobject
Show Provider mix object
enabledboolean
Whether provider matching is on for the campaign.
sendersobject
Assigned mailboxes by provider: google, microsoft, other.
leadsobject
Campaign leads by their email provider: google, microsoft, other, unresolved.
totalLeadsinteger
Leads in the campaign.
resolvedPctinteger
Share of leads (0-100) whose provider is already looked up.

Errors#

StatusDescription
404Campaign not found

Rate Limit#

  • 100 requests per minute, per API key. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 2, 2026