---
title: "GET /v2/email/contact-lists/{ContactListName}"
method: GET
path: "/v2/email/contact-lists/{ContactListName}"
---

# GET /v2/email/contact-lists/{ContactListName}

`GET /v2/email/contact-lists/{ContactListName}`

Returns contact list metadata. It does not return any information about the contacts present in the list.

## Path parameters

- `ContactListName` string, required

## Response `200`

Success

- GetContactListResponse
  - `ContactListName` string — The name of the contact list.
  - `Topics` Topic[] — An interest group, theme, or label within a list. A contact list can have multiple topics.
    - `TopicName` string, required — The name of the topic.
    - `DisplayName` string, required — The name of the topic the contact will see.
    - `Description` string — A description of what the topic is about, which the contact will see.
    - `DefaultSubscriptionStatus` 'OPT_IN' | 'OPT_OUT', required — The default subscription status to be applied to a contact if the contact has not noted their preference for subscribing to a topic.
  - `Description` string — A description of what the contact list is about.
  - `CreatedTimestamp` string, date-time — A timestamp noting when the contact list was created.
  - `LastUpdatedTimestamp` string, date-time — A timestamp noting the last time the contact list was updated.
  - `Tags` Tag[] — The tags associated with a contact list.
    - `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.

## Other responses

- `480` — TooManyRequestsException
- `481` — NotFoundException
- `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)