GeneralPOST

Playground Check

11.2 POST /playground/check — public validation without quota deduction. Use POST /v1/playground/check when you need this capability from your application or backend. It accepts a JSON request body. There are no query parameters for this operation.

Endpoint

Use this full URL directly in server-side integrations, scripts, or internal tooling.

POST request

https://api.dropfakes.com/api/v1/playground/check

Full endpoint URL

POST https://api.dropfakes.com/api/v1/playground/check

Authorization

This section explains how this endpoint should be called in the current API version.

No authorization required

This endpoint is documented as public in this version of the API reference. No bearer token is required.

Authorization

Authorization: dk_live_*****

Code examples

Start with curl, then use the language sample that matches your backend.

curl

curl -X POST "https://api.dropfakes.com/api/v1/playground/check" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "person@example.com"
}'

Parameters

Query string parameters and request body fields are listed together for faster scanning.

Name	Location	Type	Required	Description	Default
email	body	string (email)	Yes	Body field for `email`.	-

Success response

The primary success status for this operation is 200.

Status 200

Successful Response

200 application/json

{
  "email": "person@example.com",
  "domain": "example.com",
  "disposable": false,
  "mxValid": "id_123",
  "smtpReachable": false,
  "freeProvider": false,
  "roleAddress": false,
  "subaddress": false,
  "verdict": "allow",
  "riskScore": 0.08,
  "checkedAt": "2026-03-21T10:15:00.000Z",
  "domainReputation": {
    "score": 0.08,
    "categories": [
      "string"
    ]
  }
}

Error response

Use this example to handle validation and request errors safely on the client or backend.

Status 422

Validation Error

422 application/json

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}