Synchronous responses on JobRequest

Fully accepted

You will receive such a synchronous response when:

the JobRequest is valid;
AND all recipients are valid

JSON

{
   "meta":{
      "jobId":"rcpt-632cdc56-6480-406b-8faf-5a7e70876d0c",
      "receivedTs":"2020-10-20T05:13:50.404Z",
      "state":{
         "type":"ACCEPTED",
         "subType":"FULL",
         "phase":"PRE_PROCESS"
      }
   },
   "content":{
      "recipients":[
         {
            "mail":{
               "to":[
                  {
                     "id":"rcpt-632cdc56-6480-406b-8faf-5a7e70876d0c",
                     "email":"john.doe@example.com"
                  }
               ]
            }
         }
      ]
   }
}

Partially accepted

You will receive such a synchronous response when:

the JobRequest is valid;
AND if one or many recipients are invalid, due to the Suppression List, forbidden local part…

Transactional Email processing will continue for the valid recipients.

JSON

{
  "meta": {
    "jobId": "6dba7407-6c9c-4946-9553-eb9cc8eac852",
    "receivedTs": "2025-05-14T08:55:50.817Z",
    "state": {
      "type": "ACCEPTED",
      "subType": "PART",
      "phase": "PRE_PROCESS"
    }
  },
  "content": {
    "recipients": [
      {
        "mail": {
          "to": [
            {
              "id": "6dba7407-6c9c-4946-9553-eb9cc8eac852#367904a0#e8dc0309",
              "email": "john.doe@example.com"
            },
            {
              "id": "6dba7407-6c9c-4946-9553-eb9cc8eac852#367904a0#ab2be112",
              "email": "foo@bar",
              "validationResult": {
                "classifier": "INVALID_FORMAT"
              }
            },
            {
              "id": "6dba7407-6c9c-4946-9553-eb9cc8eac852#367904a0#7cd26519",
              "email": "admin@example.com",
              "validationResult": {
                "classifier": "FORBIDDEN_RECIPIENT",
                "message": "Reason: Local part forbidden by config"
              }
            }
          ]
        }
      }
    ]
  }
}

Rejected

JSON

{
   "meta":{
      "jobId":"rcpt-632cdc56-6480-406b-8faf-5a7e70876d0c",
      "state":{
         "type":"REJECTED",
         "subType":"INVALID_JSON_SYNTAX",
         "phase":"PRE_PROCESS",
         "description":"Unterminated array at line 9 column 54 path $.recipients[0].mail.to[1]"
      }
   }
}

JSON

{
   "meta":{
      "jobId":"rcpt-632cdc56-6480-406b-8faf-5a7e70876d0c",
      "state":{
         "type":"REJECTED",
         "subType":"FORBIDDEN_BY_CONFIG",
         "phase":"PRE_PROCESS",
         "description":"Unsupported value for dkim.lastCheck"
      }
   }
}

JSON

{
  "meta": {
    "jobId": "308a020f-4f71-4f4d-853d-9ccfca0b2645",
    "state": {
      "type": "REJECTED",
      "subType": "DISABLED_IN_ACCOUNT_CONFIG",
      "phase": "PRE_PROCESS",
      "description": "Feature antivirus is disabled in AccountConfig for this account/domain"
    }
  }
}