Getting the site verification information

Returns information about the current state of site verification in Yandex.Webmaster.

Request format

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/verification

Response format

Examples

JSON

XML

{
  "verification_uin": "b01288afe67b1595",
  "verification_state": "NONE",
  "verification_type": "META_TAG",
  "latest_verification_time": "2016-01-01T00:00:00,000+0300",
  "fail_info": {
    "reason": "META_TAG_NOT_FOUND",
    "message": "explicit error message"
  },
  "applicable_verifiers": [
    "META_TAG", ...
  ]
}

<Data>
    <verification_uin>b01288afe67b1595</verification_uin>
    <verification_state>NONE</verification_state>
    <verification_type>META_TAG</verification_type>
    <latest_verification_time>2016-01-01T00:00:00,000+0300</latest_verification_time>
    <fail_info>
        <reason>META_TAG_NOT_FOUND</reason>
        <message>explicit error message</message>
    </fail_info>
    <applicable_verifier>META_TAG</applicable_verifier>
    ...
</Data>

Name	Required	Type	Description
verification_uin	Yes	string	Unique authorization code.
verification_state	Yes	string (ApiVerificationState)	The rights verification state.
verification_type	Yes	string (ApiVerificationType)	The type of rights verification.
latest_verification_time	Yes	datetime	The time of the last check in the yyyy-MM-ddTHH:mm:ss,sssZ format (if verification_state isn't NONE).
fail_info	Yes		Error description if the VERIFICATION_FAILED status is received.
reason	Yes	string (ApiVerificationFailReason)	The reason why verification failed.
message	Yes	string	Error description for users.
applicable_verifiers	Yes	string (ApiExplicitVerificationType )	The verification methods applied for the given site.

Rights verification methods (ApiVerificationType)

Explicit methods of rights verification (ApiExplicitVerificationType)

The status of verifying the right to manage the site (ApiVerificationState)

Reasons for refusal to verify site management rights (ApiVerificationFailReason)

Response codes

To view the response structure in detail, click the reason.

{   
    "error_code": "INVALID_USER_ID",   
    "available_user_id": 1,   
    "error_message": "Invalid user id. {user_id} should be used."
}

<Data>     
    <error_code>INVALID_USER_ID</error_code>     
    <available_user_id>1</available_user_id>     
    <error_message>Invalid user id. {user_id} should be used.</error_message> 
</Data>

{   
    "error_code": "HOST_NOT_FOUND",   
    "host_id": "http:ya.ru:80",   
    "error_message": "explicit error message"
}

<Data>     
    <error_code>HOST_NOT_FOUND</error_code>     
    <host_id>http:ya.ru:80</host_id>     
    <error_message>explicit error message</error_message> 
</Data>

Related information

• Error codes and statuses