Getting a list of users who have verified rights

Description

Gets a list of users who have verified site management rights.

Request format

Send a GET request to the address of the resource for getting a list of users who have verified rights to the site:

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

Path parameters

NameRequiredTypeDefault valueDescription
user-idYesint64The user ID.
host-idYeshost idSite ID.

Response format

If successful, the server returns 200 OK and information about users who have verified their site management rights.

Samples

{
  "users": [
    {
      "user_login": "vassily123",
      "verification_uin": "1123",
      "verification_type": "META_TAG",
      "verification_date": "2016-01-01T00:00:00,000+0300"
    }, ...
  ]
}
NameRequiredTypeDescription
user_loginYesstringUsername.
verification_uinYesstringVerification code.
verification_typeYesApiExplicitVerificationTypeMethod for verifying rights.
verification_dateNoyyyy-MM-ddTHH:mm:ss,sssZVerification date.

Explicit methods of verifying rights (ApiExplicitVerificationType)

Verification methodWhether a verification status check can be requestedDescription
DNSYesVerifying rights using DNS records.
HTML_FILEYesPlacing an HTML file in the site's root directory.
META_TAGYesAdding a metatag to the header on the site's main page.
WHOISYes

Verifying data with the information provided by the WHOIS service.

This method only works for second-level domains (such as example.com).

Errors

403 Forbidden

The user ID for the token doesn't match the one specified in the request. In the examples below, {user_id} is the correct uid for the owner of the OAuth token.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}
ParameterDescription
error_codeError code.
available_user_idID of the user who allowed access.
error_messageError message.

404 Not Found

The site isn't in the list of the user's sites, or rights to the site haven't been verified.

{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "explicit error message"
}
ParameterDescription
error_codeError code.
host_idThe ID of the requested site.
error_messageError message.