Skip to main content
The AuthFlame API is a lightweight JSON-over-HTTPS interface for scoring email addresses at signup. This reference documents authentication, error handling, and every endpoint.

Base URL

All requests must use HTTPS. Requests over plain HTTP are rejected.

Request format

  • Method: endpoints accept POST unless otherwise noted.
  • Body: JSON. Set Content-Type: application/json.
  • Auth: bearer token in the Authorization header. See Authentication.

Response format

Successful responses are JSON objects with a stable schema per endpoint. Every check response includes:
  • summary: the recommended action, risk score, and risk level.
  • normalized: canonical parsed form of the input.
  • signals: the raw signals that produced the summary.
See Errors for the error envelope.

Endpoints

POST /api/ - Check an email address

Score an email address and get an allow or block recommendation.