# Company Email Patterns

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/company/email_pattern` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/company-email_pattern |

## Description

Discover the most common corporate email formats used by a company domain, ranked by usage percentage.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/company/email_pattern' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
[
  {
    "pattern": "[F].[L]",
    "percentage": 99.131
  },
  {
    "pattern": "[F]",
    "percentage": 0.3032
  },
  {
    "pattern": "[F1][L]",
    "percentage": 0.3032
  },
  {
    "pattern": "[F1].[L]",
    "percentage": 0.1819
  },
  {
    "pattern": "[F].[L1]",
    "percentage": 0.0404
  },
  {
    "pattern": "[L]",
    "percentage": 0.0202
  },
  {
    "pattern": "[F1]-[L1]",
    "percentage": 0.0202
  }
]
```

## Documentation

## Overview
Identify standard email address patterns for any company domain. Returns ranked format templates (e.g. `[F].[L]`, `[F1][L]`) with the percentage of employees using each pattern: essential for building accurate email permutations in outbound workflows.

## Quickstart
```
GET https://api.piloterr.com/v2/company/email_pattern?query=gucci.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Company domain (e.g. `gucci.com`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `pattern` | string | Email format template (`[F]` first name, `[L]` last name, digits for variants) |
| `percentage` | number | Share of known addresses matching this pattern |

## Main use cases
- Build email permutation lists for outbound sales at scale
- Improve Email Finder accuracy by prioritizing the dominant format
- Enrich CRM workflows with domain-specific email conventions
- Reduce bounce rates by targeting the most likely address structure