ReachScore - Email Deliverability Testing

Error Response Format

All API errors return a consistent JSON structure:

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_email_format",
    "message": "The email address is not valid.",
    "field": "from_address",
    "fix": "Use a valid email address format.",
    "request_id": "req_abc123"
  }
}

HTTP Status Codes

Status	Meaning
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - Insufficient permissions
404	Not Found - Resource does not exist
429	Rate Limited - Too many requests
500	Server Error - Internal error

Authentication Errors

invalid_api_key

The API key is malformed or does not exist.

missing_api_key

No API key was provided in the Authorization header.

expired_api_key

The API key has been revoked or expired.

insufficient_scope

The API key does not have permission for this action.

Validation Errors

invalid_email_format

The email address format is invalid.

invalid_domain

The domain format is invalid or does not resolve.

invalid_url

The URL is invalid or blocked (SSRF protection).

missing_required_field

A required field was not provided.

invalid_provider

The provider name is not recognized.

Resource Errors

resource_not_found

The requested resource does not exist.

domain_not_verified

Domain ownership has not been verified.

quota_exceeded

Monthly test quota has been exceeded.

test_in_progress

Cannot modify a test while it is running.

Rate Limit Errors

rate_limit_exceeded