[Документация Yandex Cloud](../../../index.md) > [Yandex Cloud Postbox](../../index.md) > [Справочник API](../index.md) > [REST](index.md) > Адреса > Метод GetDomainIdentity

# Метод GetDomainIdentity

Возвращает информацию об [адресе](../../concepts/glossary.md#adress) в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.

## Запрос {#request}

```http
GET /v2/email/identities/{DomainIdentity} HTTP/2
```

### Path-параметры {#path-parameters}

#|
|| **Параметр** | **Описание** ||
|| `DomainIdentity` | **Тип**: string.

Адрес, о котором запрашивается информация. Минимальная длина — один символ. ||
|#

### Заголовки запроса {#request-headers}

Используйте в запросе [общие заголовки](request-headers.md).

## Ответы {#responses}

### 200 OK {#200}

```json
{
  "IdentityType": "<тип_адреса>",
  "FeedbackForwardingStatus": <статус_уведомлений_о_неполадках>,
  "VerifiedForSendingStatus": <статус_верификации_для_отправки_писем>,
  "DkimAttributes": {
    "SigningEnabled": <использование_DKIM>,
    "Status": "<статус_поиска_DKIM>",
    "Tokens": [
      "<селектор_для_открытого_ключа>"
    ],
    "SigningAttributesOrigin": "<способ_конфигурации_DKIM>",
    "NextSigningKeyLength": "<длина_следующего_ключа>",
    "CurrentSigningKeyLength": "<длина_текущего_ключа>"
  },
  "Tags": [
    {
      "Key": "<ключ_метки>",
      "Value": "<значение_метки>"
    }
  ],
  "ConfigurationSetName": "<название_конфигурации>",
  "VerificationStatus": "<статус_верификации_адреса>"
}
```

#|
|| **Параметр** | **Описание** ||
|| `IdentityType` | **Тип**: string.

Тип адреса. Значение — `DOMAIN`. ||
|| `FeedbackForwardingStatus` | **Тип**: boolean.

Возможные значения: `true` или `false`. Если указано значение `true`, вы будете получать уведомления в случае неполадок с доставкой и отправкой писем. ||
|| `VerifiedForSendingStatus` | **Тип**: boolean.

Указывает, можно ли отправлять электронную почту с этого адреса. Возможные значения: `true` или `false`.
Чтобы отправлять почту, адрес необходимо верифицировать. ||
|| `DkimAttributes` | **Тип**: object.

Объект, который содержит параметры DKIM-подписи. ||
|| `SigningEnabled` | **Тип**: boolean.

Указывает, используется ли DKIM-подпись при отправке электронной почты с этого адреса. Возможные значения: `true` или `false`. ||
|| `Status` | **Тип**: string.

Указывает, удалось ли Yandex Cloud Postbox обнаружить DKIM-подпись в DNS-конфигурации адреса. Возможные значения:
  * `PENDING` — поиск запущен, но сервис пока не обнаружил DKIM-подпись в DNS-конфигурации адреса.
  * `SUCCESS` — DKIM-подпись обнаружена.
  * `FAILED` — не удалось обнаружить DKIM-подпись.
  * `TEMPORARY_FAILURE` — из-за временной проблемы Yandex Cloud Postbox не может обнаружить DKIM-подпись.
  * `NOT_STARTED` — поиск не был запущен. ||
|| `Tokens` | **Тип**: array.
  
Список селекторов для идентификации открытого ключа. Тип для селектора: string. ||
|| `SigningAttributesOrigin` | **Тип**: string.

Указывает, как была настроена DKIM-подпись. Возможные значения:

  * `AWS_SES` — простая настройка (Easy DKIM): ключи DKIM сгенерированы Yandex Cloud Postbox.
  * `EXTERNAL` — расширенная настройка (BYODKIM): пользователь указал собственный ключ. ||
|| `NextSigningKeyLength` | **Тип**: string.

Длина ключа RSA, который будет использован при следующей ротации ключа DKIM при простой настройке (Easy DKIM). Возможные значения: `RSA_2048_BIT`, `RSA_1024_BIT`. ||
|| `CurrentSigningKeyLength` | **Тип**: string.

Длина текущего ключа RSA, который используется для DKIM-подписи при простой настройке (Easy DKIM). Возможные значения: `RSA_2048_BIT`, `RSA_1024_BIT`. ||
|| `Tags` | **Тип**: array.

Массив меток для адреса. ||
|| `ConfigurationSetName` | **Тип**: string.

Название конфигурации. ||
|| `VerificationStatus` | **Тип**: string.

Статус верификации:
  * `PENDING` — верификация была запущена, но в Yandex Cloud Postbox пока не удалось подтвердить адрес.
  * `SUCCESS` — верификация успешно завершена.
  * `FAILED` — не удалось выполнить верификацию.
  * `TEMPORARY_FAILURE` — из-за временной проблемы Yandex Cloud Postbox не может определить статус верификации.
  * `NOT_STARTED` — верификация не была запущена. ||
|#

### Ошибки {#errors}

Для всех ошибок тело ответа представлено в одинаковом формате:

```json
{
   "Code": "<название_ошибки>",
   "message": "<пояснение_к_ошибке>"
}
```

Название ошибки заимствуется из ее кода, например `BadRequestException`.

Возможные ошибки:

#|
|| **Код ошибки** | **Описание** ||
|| `400 BadRequestException` | В запросе неправильно указаны заголовки или параметры. ||
|| `404 NotFoundException` | Запрошенный ресурс не найден. ||
|| `429 TooManyRequestsException` | При вызове запроса превышена [квота](../../concepts/limits.md#postbox-quotas). ||
|#