# Get Lead Mail Providers

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

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](/api-reference/leads/list-leads) with `provider`.

## Response

<ResponseField name="data" type="object">
  <Expandable title="Provider summary">
    <ResponseField name="counts" type="object">
      Every lead counted once: `google`, `microsoft`, `zoho`, `yahoo` (Yahoo and AOL), `godaddy`, `other`, and `unresolved` (not checked yet).
    </ResponseField>
    <ResponseField name="gateway" type="integer">
      Leads whose mail goes through a security filter such as Proofpoint, Mimecast or Barracuda. These leads are also counted under their provider in `counts`.
    </ResponseField>
    <ResponseField name="total" type="integer">Number of leads in the workspace.</ResponseField>
    <ResponseField name="resolvedPct" type="integer">Percentage of leads whose provider is known.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
```bash cURL
curl -X GET "https://api.foxreach.io/api/v1/leads/providers" \
  -H "X-API-Key: otr_your_key"
```

```python Python SDK (beta)
from foxreach import FoxReach

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

```typescript TypeScript SDK (beta)
import { FoxReach } from "foxreach";

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

```bash CLI (beta)
foxreach leads providers
```
</RequestExample>

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

## 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](/rate-limiting).