Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud Postbox
  • Getting started
  • Access management
  • Pricing policy
    • Authentication with the API
    • How to use the API
    • Signing requests
      • All methods
      • Sending emails
        • ListDomainIdentities method
        • GetDomainIdentity method
        • CreateDomainIdentity method
        • PutDomainIdentityDkimAttributes method
        • DeleteDomainIdentity method
      • Request headers
  • Audit Trails events
  • Release notes

In this article:

  • Request
  • Path parameters
  • Request headers
  • Responses
  • 200 OK
  • Errors
  1. API reference
  2. REST
  3. Addresses
  4. GetDomainIdentity method

GetDomainIdentity method

Written by
Yandex Cloud
Updated at October 22, 2024
  • Request
    • Path parameters
    • Request headers
  • Responses
    • 200 OK
    • Errors

This method returns information on an address in a folder. The folder is selected based on the service account the request originates from.

RequestRequest

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

Path parametersPath parameters

Parameter

Description

DomainIdentity

Type: String.

Address you are requesting info on. The minimum length is one character.

Request headersRequest headers

Use common request headers in your requests.

ResponsesResponses

200 OK200 OK

{
  "IdentityType": "<address_type>",
  "FeedbackForwardingStatus": <issue_notification_status>,
  "VerifiedForSendingStatus": <verification_status_for_sending_emails>,
  "DkimAttributes": {
    "SigningEnabled": <DKIM_usage>,
    "Status": "<DKIM_search_status>",
    "Tokens": [
      "<public_key_selector>"
    ],
    "SigningAttributesOrigin": "<DKIM_configuration_method>",
    "NextSigningKeyLength": "<compatibility_parameter>",
    "CurrentSigningKeyLength": "<compatibility_parameter>"
  },
  "Tags": [
    {
      "Key": "<label_key>",
      "Value": "<label_value>"
    }
  ],
  "ConfigurationSetName": "<configuration_name>",
  "VerificationStatus": "<address_verification_status>"
}

Parameter

Description

IdentityType

Type: String.

Address type. Value: DOMAIN.

FeedbackForwardingStatus

Type: Boolean.

The possible values are true or false. If set to true, you will be getting notifications about issues with delivering and sending emails.

VerifiedForSendingStatus

Type: Boolean.

Indicates whether the address can be used to send emails. The possible values are true or false.
To send emails, you need to verify the address.

DkimAttributes

Type: Object.

Object that contains the DKIM signature parameters.

SigningEnabled

Type: Boolean.

Indicates whether a DKIM signature is used when sending from this address. The possible values are true or false.

Status

Type: String.

Indicates whether Yandex Cloud Postbox was able to detect a DKIM signature in the DNS configuration of the address. The possible values are:

  • PENDING: Search is ongoing, but Yandex Cloud Postbox has not yet detected a DKIM signature in the DNS configuration of this address.
  • SUCCESS: DKIM signature detected.
  • FAILED: Failed to detect a DKIM signature.
  • TEMPORARY_FAILURE: Yandex Cloud Postbox is not able to detect a DKIM signature due to a temporary issue.
  • NOT_STARTED: Search was not started.

Tokens

Type: Array.

List of selectors for public key identification. Selector type: String.

SigningAttributesOrigin

Type: String.

Indicates how the DKIM signature was configured. EXTERNAL means that the DKIM signature was configured using BYODKIM.

NextSigningKeyLength

Type: String.

Only used to ensure compatibility with AWS.

CurrentSigningKeyLength

Type: String.

Only used to ensure compatibility with AWS.

Tags

Type: Array.

Address label array.

ConfigurationSetName

Type: String.

Configuration name.

VerificationStatus

Type: String.

Verification status:

  • PENDING: Verification is ongoing, but so far Yandex Cloud Postbox was not able to verify the address.
  • SUCCESS: Address successfully verified.
  • FAILED: Verification failed.
  • TEMPORARY_FAILURE: Yandex Cloud Postbox is not able to identify the verification status due to a temporary issue.
  • NOT_STARTED: Verification was not started.

ErrorsErrors

For all errors, the response body has the same format:

{
   "Code": "<error_name>",
   "message": "<error_description>"
}

The name of the error is taken from its code, e.g., BadRequestException.

Possible errors:

Error code

Description

400 BadRequestException

The request contains invalid headers or parameters.

404 NotFoundException

The requested resource was not found.

429 TooManyRequestsException

The request quota was exceeded.

Was the article helpful?

Previous
ListDomainIdentities method
Next
CreateDomainIdentity method
Yandex project
© 2025 Yandex.Cloud LLC