api.
API Reference

Batch Check Emails

POST
/v1/external-api-requests/batch-check-emails

Batch email verification from file. Accepts CSV, TXT, or Excel files. Auth: X-API-Key header. Returns a task_id for status polling.

Authorization

ApiKeyAuth
X-API-Key<token>

In: header

Request Body

multipart/form-data

file*file
Formatbinary
project_name*string
Length1 <= length <= 50
deduplicate?boolean
Defaulttrue

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

const body = new FormData();body.set(file, "string")body.set(project_name, "string")fetch("http://91.99.239.149:8000/v1/external-api-requests/batch-check-emails", {  method: "POST",  headers: {    "Content-Type": "multipart/form-data"  },  body})
{
  "task_id": "468e0130-bb87-4db6-8140-8d9aa91d6134",
  "status": "processing",
  "message": "File upload successful. Processing started."
}

{
  "detail": "Invalid API key."
}

{
  "detail": "No auth provided"
}
{
  "detail": "Insufficient credits — please top up your balance."
}
{
  "detail": "Storage quota exceeded, please delete old projects."
}
{
  "detail": [
    {
      "type": "string_too_short",
      "loc": [
        "body",
        "project_name"
      ],
      "msg": "String should have at least 1 character",
      "input": "",
      "ctx": {
        "min_length": 1
      }
    }
  ]
}
{
  "error": "Rate limit exceeded: 100 per 1 minute"
}
{
  "detail": "Error processing file"
}

Check Email POST

Single email verification. **Auth:** `X-API-Key` header.

Check Batch Task Status GET

Check status of batch email verification task. Poll this endpoint until status is 'SUCCESS' or 'FAILURE'. **Auth:** `X-API-Key` header.