ADadaptivesecurity
Email Security

List email security rules

Changed on

Returns enabled, company-configured, non-deleted sender rules ordered by creation time. Adaptive-configured rules are excluded. Omit listType to return both allow and deny rules. Response fields use snake_case.

Required permission: email_security:read

get/v2/email-security/settings/rules

Request

  • Base URL
    https://api.adaptivesecurity.com
  • URL
    https://api.adaptivesecurity.com/v2/email-security/settings/rules
  • Auth
    HTTP bearer

Query parameters

listType'ALLOW' | 'DENY' nullable

Filter to ALLOW or DENY rules

Response

Successfully retrieved rules. Returns an empty rules array when no rules match.

Example response

{
  "rules": [
    {
      "auth_requirement": "AUTHENTICATED",
      "created": "2026-09-22T14:00:00Z",
      "header_rules": {
        "operator": "AND",
        "rules": [
          {
            "header": "X-Partner",
            "value": "trusted",
            "value_type": "STATIC"
          }
        ]
      },
      "id": "a785a60e-a8ba-4750-8607-e9e977b9e0c4",
      "list_type": "ALLOW",
      "name": "My custom rule",
      "rule_type": "DOMAIN",
      "updated": "2026-09-23T15:00:00Z",
      "value": "example.com"
    }
  ]
}

Changes

  • 41f0ca9c551aRevision changes
    • breaking

      added subschema #2 to the // response property oneOf list for the response status

    • breaking

      removed the required property /// from the response with the status

    • breaking

      removed the required property /// from the response with the status

  • 1e527b1a2d31Revision changes
    • info

      endpoint added