---
title: "GET /v2/email/configuration-sets/{ConfigurationSetName}"
method: GET
path: "/v2/email/configuration-sets/{ConfigurationSetName}"
---

# GET /v2/email/configuration-sets/{ConfigurationSetName}

`GET /v2/email/configuration-sets/{ConfigurationSetName}`

Get information about an existing configuration set, including the dedicated IP pool that it's associated with, whether or not it's enabled for sending email, and more.

_Configuration sets_ are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

## Path parameters

- `ConfigurationSetName` string, required — <p>The name of a configuration set.</p> <p> <i>Configuration sets</i> are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.</p>

## Response `200`

Success

- GetConfigurationSetResponse — Information about a configuration set.
  - `ConfigurationSetName` string — The name of the configuration set.
  - `TrackingOptions` object — An object that defines the open and click tracking options for emails that you send using the configuration set.
    - `CustomRedirectDomain` string, required — The domain to use for tracking open and click events.
  - `DeliveryOptions` object — An object that defines the dedicated IP pool that is used to send emails that you send using the configuration set.
    - `TlsPolicy` 'REQUIRE' | 'OPTIONAL' — Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is <code>Require</code>, messages are only delivered if a TLS connection can be established. If the value is <code>Optional</code>, messages can be delivered in plain text if a TLS connection can't be established.
    - `SendingPoolName` string — The name of the dedicated IP pool to associate with the configuration set.
  - `ReputationOptions` object — An object that defines whether or not Amazon SES collects reputation metrics for the emails that you send that use the configuration set.
    - `ReputationMetricsEnabled` boolean — If <code>true</code>, tracking of reputation metrics is enabled for the configuration set. If <code>false</code>, tracking of reputation metrics is disabled for the configuration set.
    - `LastFreshStart` string, date-time — The date and time (in Unix time) when the reputation metrics were last given a fresh start. When your account is given a fresh start, your reputation metrics are calculated starting from the date of the fresh start.
  - `SendingOptions` object — An object that defines whether or not Amazon SES can send email that you send using the configuration set.
    - `SendingEnabled` boolean — If <code>true</code>, email sending is enabled for the configuration set. If <code>false</code>, email sending is disabled for the configuration set.
  - `Tags` Tag[] — An array of objects that define the tags (keys and values) that are associated with the configuration set.
    - `Key` string, required — One part of a key-value pair that defines a tag. The maximum length of a tag key is 128 characters. The minimum length is 1 character.
    - `Value` string, required — The optional part of a key-value pair that defines a tag. The maximum length of a tag value is 256 characters. The minimum length is 0 characters. If you don't want a resource to have a specific tag value, don't specify a value for this parameter. If you don't specify a value, Amazon SES sets the value to an empty string.
  - `SuppressionOptions` object — An object that contains information about the suppression list preferences for your account.
    - `SuppressedReasons` SuppressionListReason[] — <p>A list that contains the reasons that email addresses are automatically added to the suppression list for your account. This list can contain any or all of the following:</p> <ul> <li> <p> <code>COMPLAINT</code> – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.</p> </li> <li> <p> <code>BOUNCE</code> – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.</p> </li> </ul>
  - `VdmOptions` object — An object that contains information about the VDM preferences for your configuration set.
    - `DashboardOptions` object — Specifies additional settings for your VDM configuration as applicable to the Dashboard.
      - `EngagementMetrics` 'ENABLED' | 'DISABLED' — <p>Specifies the status of your VDM engagement metrics collection. Can be one of the following:</p> <ul> <li> <p> <code>ENABLED</code> – Amazon SES enables engagement metrics for the configuration set.</p> </li> <li> <p> <code>DISABLED</code> – Amazon SES disables engagement metrics for the configuration set.</p> </li> </ul>
    - `GuardianOptions` object — Specifies additional settings for your VDM configuration as applicable to the Guardian.
      - `OptimizedSharedDelivery` 'ENABLED' | 'DISABLED' — <p>Specifies the status of your VDM optimized shared delivery. Can be one of the following:</p> <ul> <li> <p> <code>ENABLED</code> – Amazon SES enables optimized shared delivery for the configuration set.</p> </li> <li> <p> <code>DISABLED</code> – Amazon SES disables optimized shared delivery for the configuration set.</p> </li> </ul>

## Other responses

- `480` — NotFoundException
- `481` — TooManyRequestsException
- `482` — BadRequestException

---

[API](https://skmtc.net/aws/apis/sesv2.md) · [All operations](https://skmtc.net/aws/apis/sesv2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/sesv2/versions/25eba06e7f64/schema)