HTTP Response Codes

HTTP response codes returned by MassAccess API for /api/v1/ endpoints.

HTTP Status	Code	Description
202	ACCEPTED	Message accepted into processing queue
401	UNAUTHORIZED	Invalid or missing X-API-Key
422	VALIDATION_ERROR	Validation error
429	RATE_LIMIT	Too many requests
500	INTERNAL_ERROR	Server-side error

Success Response

202 Accepted

json

{
  "status": "accepted",
  "data": {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "new"
  }
}

When an error occurs, the API returns a JSON object with error details:

json

{
  "status": "error",
  "code": "INTERNAL_ERROR"
}