Target Group Validation

Validate email addresses against specific target groups with enterprise-grade reliability

Create Target Group

Create a new target group for email validation.

POST/api/v1/target-groups

Loading syntax highlighting...

Request Example

POST/api/v1/validate/target-group

POST /api/v1/validate/target-group
Content-Type: application/json
Authorization: Bearer ck_live_your_api_key

{
  "email": "student@stanford.edu",
  "targetGroupId": "clh1234567890"
}

Enhanced Features

• Comprehensive input validation and sanitization
• Detailed error messages with field-level validation
• Request tracking with unique request IDs
• Performance monitoring and logging
• Automatic email format validation

Response Examples

Successful Validation

Loading syntax highlighting...

Failed Validation

Loading syntax highlighting...

Validation Error

Loading syntax highlighting...

Enhanced Error Handling

HTTP Status Codes

400

Bad Request

Invalid request data, malformed JSON, or validation errors

401

Unauthorized

Invalid or missing API key

403

Forbidden

API key does not have validate:target-groups scope

429

Too Many Requests

Rate limit exceeded for your API key

503

Service Unavailable

Validation service temporarily unavailable

500

Internal Server Error

An unexpected error occurred on our servers

Error Codes

MALFORMED_JSONInvalid JSON in request body

VALIDATION_ERRORRequest data validation failed

INVALID_EMAIL_FORMATEmail format is invalid

SERVICE_ERRORValidation service error

MISSING_API_KEYAuthorization header missing

INVALID_API_KEYAPI key is invalid or expired

INSUFFICIENT_SCOPEAPI key lacks required permissions

RATE_LIMIT_EXCEEDEDToo many requests from API key