Get Lead Mail Providers

Count your leads by the mail provider that hosts their email address.

GEThttps://api.foxreach.io/api/v1/leads/providers

Returns how many leads in the workspace are on Google, Microsoft, Zoho, Yahoo, GoDaddy or another provider, how many go through a security filter, and how many are not checked yet. The provider comes from each email domain's mail server (MX) records.

Calling this endpoint starts checking the workspace's unchecked domains in the background. Call it again a few minutes later to see the counts move from unresolved to a provider. To list the leads in one group, use List Leads with provider.

Response#

dataobject

Show Provider summary

countsobject

Every lead counted once: google, microsoft, zoho, yahoo (Yahoo and AOL), godaddy, other, and unresolved (not checked yet).

gatewayinteger

Leads whose mail goes through a security filter such as Proofpoint, Mimecast or Barracuda. These leads are also counted under their provider in counts.

totalinteger

Number of leads in the workspace.

resolvedPctinteger

Percentage of leads whose provider is known.

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, see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/leads/providers" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
summary = client.leads.providers()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const summary = await client.leads.providers();

foxreach leads providers

Response

{
  "data": {
    "counts": {
      "google": 412,
      "microsoft": 268,
      "zoho": 31,
      "yahoo": 9,
      "godaddy": 6,
      "other": 49,
      "unresolved": 15
    },
    "gateway": 88,
    "total": 790,
    "resolvedPct": 98
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026