API
Reference

Reference

GET /status

Get a status of API key.

Example request

curl --request GET \
 --url https://api.signupgate.com/v1/status \
 --header 'accept: application/json' \
 --header 'Authorization: Bearer [YOUR_API_KEY]'

Example response

{
  "success": true,
  "data": {
    "status": "ok"
  }
}

GET /check

Check the risk level of an email, domain, or IP-address.

Parameters

ParameterDescriptionDefault value
qEmail, domain, or IP-address to checkN/A

Example request

curl --request GET \
 --url 'https://api.signupgate.com/v1/check?q=example@temp-mail.ml' \
 --header 'accept: application/json' \
 --header 'Authorization: Bearer [YOUR_API_KEY]'

Example response

{
  "success": true,
  "data": {
    "subject": "example@temp-mail.ml",
    "subject_type": "email",
    "risk_level": "high"
  }
}

Risk Levels

The risk_level field can contain the following values:

  • "high" - High risk, should be rejected
  • "medium" - Medium risk, recommended to reject
  • "low" - Low risk
  • "none" - No risk detected
⚠️

Users with "high" risk level should be rejected. We also recommend rejecting users with "medium" risk level for enhanced security.