Skip to content

API response format

Every Apixies endpoint returns the same JSON shape with standard HTTP status codes. Here's the structure, how errors look and which fields you can rely on.

The envelope

All responses share the same envelope:

success200
{
  "status": "success",
  "http_code": 200,
  "code": "INSPECT_EMAIL_OK",
  "message": "Email inspection successful",
  "data": { ... }
}
error422
{
  "status": "error",
  "http_code": 422,
  "code": "VALIDATION_FAILED",
  "message": "Invalid email address",
  "errors": { "email": ["The email must be valid."] }
}

Fields

field type description
status string "success" or "error".
http_code integer The HTTP status code, repeated in the body.
code string A machine-readable code like SUCCESS or VALIDATION_FAILED. Branch on this.
message string A short human-readable summary.
data object The result. Only on success.
errors object Field-level error details. Only on errors, in place of data.

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy