# Errors

In case of an error, either on client or server, the API response contains a well formed JSON object including the error code, description and other additional error metadata.

## Definition


```json
{
  "type": "object",
  "description": "root error object",
  "properties": {
    "errors": {
      "type": "array",
      "description": "Array[Error]",
      "items": {
        "type": "object",
        "description": "the error object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "errorDescription": {
            "type": "string",
            "description": "The error description"
          },
          "additionalCode": {
            "type": "string",
            "description": "Additional Error Code [Optional]"
          },
          "additionalInfo": {
            "type": "string",
            "description": "Additional information about the error [Optional]"
          },
          "additionalParameters": {
            "type": "array",
            "description": "The fields that might be incorrect in the request [Optional]",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "errorCode",
          "errorDescription"
        ]
      }
    }
  },
  "required": [
    "errors"
  ]
}
```

##### Example


```md
{
  "errors": [
    {
      "errorCode": "invalid_service_combination",
      "errorDescription": "Unsupported combination of service and special service.",
      "additionalCode": "1021119",
      "additionalInfo": "Unsupported special service for selected Mail Service and or Parcel Type."
    },
    {
      "errorCode": "validation_error",
      "errorDescription": "Invalid or missing unit of measurement / weight value.",
      "additionalCode": "1000044",
      "additionalParameters": ["Weight UOM"]
    }
  ]
}
```

## Codes