# Response Codes

# **Status Codes**

| Status Code | Description                                        |
| :---------- | :------------------------------------------------- |
| 202         | Accepted: Email Request is accepted for processing |
| 200         | OK: (For Sandbox mode)                             |
| 400         | Bad Request: Invalid request data                  |
| 401         | Unauthorized: Invalid product token                |
| 403         | Forbidden: Email rejected (size/content)           |
| 500         | Internal Server Error: Server-side error           |

***

# **Responses**

All responses follow a consistent format:

```json
{
    "status": 202,
    "message": "Accepted",
    "success": true,
    "messageId": "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
}
```
```yaml
status: 202
message: "Accepted"
success: true
messageId: "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
```

## Successful Response (202)

```json
{
    "status": 202,
    "message": "Accepted",
    "success": true,
    "messageId": "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
}
```
```yaml
status: 202
message: "Accepted"
success: true
messageId: "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
```

## Successful Response (200)

```json
{
    "status": 200,
    "message": "Sandbox mode is enabled. The messages is accepted but will not be sent.",
    "success": true,
    "messageId": "df9990e2-f7cb-450d-9528-6e6698c8abab"
}
```
```yaml
status: 200
message: "Sandbox mode is enabled. The messages is accepted but will not be sent."
success: true
messageId: "df9990e2-f7cb-450d-9528-6e6698c8abab"
```

## Invalid Priority (400)

```json
{
    "status": 400,
    "message": "Priority must be 'low' or 'high'.",
    "success": false,
    "messageId": ""
}
```
```yaml
status: 400
message: "Priority must be 'low' or 'high'."
success: false
messageId: ""
```

## Invalid Product Token (401)

```json
{
    "status": 401,
    "message": "Product token is mandatory.",
    "success": false,
    "messageId": ""
}
```
```yaml
status: 401
message: "Product token is mandatory."
success: false
messageId: ""
```

## Invalid Request (400)

```json
{
    "status": 400,
    "message": "From Address is invalid or empty",
    "success": false,
    "messageId": ""
}
```
```yaml
status: 400
message: "From Address is invalid or empty"
success: false
messageId: ""
```

## Recipients Limit Exceeded (400)

```json
{
  "status": 400,
  "message": "Recipients count exceeds the max allowed limit of 50",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}
```
```yaml
status: 400
message: "Recipients count exceeds the max allowed limit of 50"
success: false
messageId: "550e8400-e29b-41d4-a716-446655440000"
```

## Email Too Large (403)

```json
{
  "status": 403,
  "message": "Email size exceeds maximum allowed size",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}
```
```yaml
status: 403
message: "Email size exceeds maximum allowed size"
success: false
messageId: "550e8400-e29b-41d4-a716-446655440000"
```

## Internal Server Error (500)

```json
{
  "status": 500,
  "message": "Internal server error occurred",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}
```
```yaml
status: 500
message: "Internal server error occurred"
success: false
messageId: "550e8400-e29b-41d4-a716-446655440000"
```