> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fraudiant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get started with Fraudiant in minutes — detect and block disposable email addresses in real time.

## Get Your API Key

To start using Fraudiant, you'll need an API key:

<Steps>
  <Step title="Sign Up">
    Create a free account at [app.fraudiant.com](https://app.fraudiant.com)
  </Step>

  <Step title="Get Your API Key">
    After logging in, navigate to the **API Keys** section in your dashboard and copy your key.
  </Step>

  <Step title="Make Your First Request">
    Use the example below to validate your first email address.
  </Step>
</Steps>

<Warning>
  Keep your API key secure! Never expose it in client-side code or public repositories.
</Warning>

***

## Make Your First Request

Here's a simple example to check if an email address is disposable:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.fraudiant.com/email/[email protected]" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.fraudiant.com/email/[email protected]', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'Authorization': 'Bearer YOUR_API_KEY'
  }

  response = requests.get(
      'https://api.fraudiant.com/email/[email protected]',
      headers=headers
  )

  data = response.json()
  print(data)
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init();

  curl_setopt($ch, CURLOPT_URL, 'https://api.fraudiant.com/email/[email protected]');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'Authorization: Bearer YOUR_API_KEY'
  ]);

  $response = curl_exec($ch);
  curl_close($ch);

  $data = json_decode($response, true);
  print_r($data);
  ?>
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "status": 200,
  "email": "[email protected]",
  "normalized_email": "[email protected]",
  "domain": "tempmail.com",
  "domain_age_in_days": 1234,
  "mx": true,
  "mx_records": ["mx1.tempmail.com"],
  "disposable": true,
  "disposable_provider": "tempmail.com",
  "public_domain": false,
  "relay_domain": false,
  "role_account": false,
  "did_you_mean": null,
  "blocklisted": false,
  "spam": true
}
```

<Info>
  In this example, `disposable: true` indicates that the email is from a temporary email provider and should likely be blocked.
</Info>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Learn about secure authentication methods
  </Card>

  <Card title="Email Endpoint" icon="envelope" href="/api-reference/email-endpoint">
    Explore the email validation endpoint
  </Card>

  <Card title="Domain Endpoint" icon="globe" href="/api-reference/domain-endpoint">
    Check domain reputation and validity
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/api-reference/rate-limits">
    Understand API rate limits and quotas
  </Card>
</CardGroup>
