Retrieve bounce purge mail settings

v1.0.0

This endpoint allows you to retrieve your current bounce and purge settings.

The Bounce Perge setting allows you to set a schedule that Twilio SendGrid will use to automatically delete contacts from your soft and hard bounce suppression lists.

A hard bounce occurs when an email message has been returned to the sender because the recipient's address is invalid. A hard bounce might occur because the domain name doesn't exist or because the recipient is unknown.

A soft bounce occurs when an email message reaches the recipient's mail server but is bounced back undelivered before it actually reaches the recipient. A soft bounce might occur because the recipient's inbox is full.

You can also manage this setting in the . You can manage your bounces manually using the or the .

Input

{
  "type": "object",
  "properties": {
    "on-behalf-of": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

Output

{
  "type": "object",
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "Indicates if the bounce purge mail setting is enabled."
    },
    "hard_bounces": {
      "type": "integer",
      "description": "The number of days after which SendGrid will purge all contacts from your hard bounces suppression lists."
    },
    "soft_bounces": {
      "type": "integer",
      "description": "The number of days after which SendGrid will purge all contacts from your soft bounces suppression lists."
    }
  }
}