Email Risk
==========

Email validation and fraud risk scoring.

POST /api/v1/email/risk
-----------------------

Validate a single email address and assess its fraud risk.

**Parameters**

.. list-table::
   :header-rows: 1
   :widths: 15 10 10 65

   * - Name
     - In
     - Required
     - Description
   * - ``email``
     - body
     - yes
     - Email address to check

**Example**

.. code-block:: bash

   curl -X POST https://api.apicrate.io/api/v1/email/risk \
     -H "X-API-Key: $KEY" \
     -H "Content-Type: application/json" \
     -d '{"email": "user@example.com"}'

.. code-block:: json

   {
     "email": "user@example.com",
     "valid_syntax": true,
     "domain_exists": true,
     "disposable": false,
     "free_provider": true,
     "risk_score": 0.15,
     "risk_level": "low"
   }

POST /api/v1/email/risk/bulk
-----------------------------

Validate multiple email addresses in a single request.

**Parameters**

.. list-table::
   :header-rows: 1
   :widths: 15 10 10 65

   * - Name
     - In
     - Required
     - Description
   * - ``emails``
     - body
     - yes
     - Array of email addresses. Maximum 10 items.

**Example**

.. code-block:: bash

   curl -X POST https://api.apicrate.io/api/v1/email/risk/bulk \
     -H "X-API-Key: $KEY" \
     -H "Content-Type: application/json" \
     -d '{"emails": ["user@gmail.com", "test@tempmail.xyz"]}'

.. code-block:: json

   {
     "results": [
       {
         "email": "user@gmail.com",
         "valid_syntax": true,
         "domain_exists": true,
         "disposable": false,
         "free_provider": true,
         "risk_score": 0.1,
         "risk_level": "low"
       },
       {
         "email": "test@tempmail.xyz",
         "valid_syntax": true,
         "domain_exists": true,
         "disposable": true,
         "free_provider": false,
         "risk_score": 0.85,
         "risk_level": "high"
       }
     ]
   }