<topic xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="ErrorCodes" xml:lang="en" xsi:noNamespaceSchemaLocation="urn:yandex:names:tc:dita:xsd:yandexTopic.xsd:1.3"Error and warning codes
This section provides codes and descriptions of errors and warnings in response messages from the Yandex Direct API versions 4 and Live 4.

Note

The short error description is returned in English by default, or in the language specified in the locale parameter in the request (such as “ru” for Russian).

Errors

Code

Short description

Explanation

1

Invalid CampaignID

Invalid CampaignID identifier for a campaign.

2

There are no statistics for this campaign

There are no statistics for this campaign.

3

Invalid date

Invalid format for either the StartDate or EndDate parameter.

5

Invalid time interval

Invalid time period for generating statistics: the start date is later than the end date.

8

Invalid limits

The maximum number of strings in the report is defined incorrectly (Limit parameter). The value for this parameter must be a number greater than zero.

9

This field must be an array

Invalid type for one of the parameters. An array is expected but a scalar type or a data structure has been specified.

10

Invalid banner filter parameters

Invalid filter by ads (Banner parameter).

11

Invalid geotargeting filter parameters

Invalid filter by region (Geo parameter).

12

Invalid website filter parameters

Invalid filter by page (PageName parameter).

13

Invalid website type filter parameters

Invalid site type in the page filter (Page parameter).

14

Invalid keyword settings filter parameters

Invalid filter by keywords (Phrase parameter).

15

Bad page type

Invalid filter by type of target page (PageType parameter). For example, a value is defined incorrectly.

16

Invalid group by date settings

Invalid date filter (Date parameter).

17

Invalid name for a report field

The value of the GroupByColumn parameter is incorrect.

18

Invalid offset

Invalid Offset parameter.

20

Invalid report type

Invalid report type (TypeResultReport parameter).

21

Invalid report compression method

Invalid type of report compression (CompressReport parameter).

22

Invalid ReportID

Invalid report identifier ReportID when calling methods GetReportList and DeleteReport.

23

Invalid BannerID

Invalid ad identifier BannerID when calling methods CreateNewReport, GetBannerPhrase, GetBanners, UpdatePrices.

24

The specified report does not exist

The specified report has not been created.

31

Report queue limit reached

The report queue is full.

32

Invalid PositionType

Invalid filter by position (PositionType parameter).

33

Invalid target filter parameters

Invalid filter by goals (StatGoals parameter).

48

Invalid filter parameters

Invalid value for one or more parameters for filtering report records.

94

There are no statistics for these campaigns.

Common error codes

25

The field can contain the value: Yes or No

The input parameter only accepts the values “Yes” and “No”.

30

The array cannot be empty

The input parameter cannot be an empty array and must contain a value.

34

Invalid email format

35

Invalid phone number format

36

Invalid format for a time tag

52

Authentication is temporarily unavailable

The Yandex Direct API server is temporarily unable to get information about user authorization from the Yandex Passport service. Try calling the method again later.

53

Authorization error

Invalid authorization data. Check the user's name and the OAuth token, including the token expiration date.

54

Not enough rights

  • You are not authorized to perform the requested operation.

  • The advertiser's account must be switched to a currency.

55

This method does not exist

A non-existent method is being called.

56

Request limit exceeded

You have reached the technical limit for the number of method calls.

57

Limit exceeded for simultaneous requests of the method

58

No access

Submit the Yandex Direct API access request form and wait for confirmation.

59

Deprecated method

This method will be disabled soon. Use version 5 of the API.

For information about how version 5 differs from version 4 and how their methods correspond, see the Migration guide.

71

Invalid request parameters

One of the parameters is defined incorrectly.

80

The object was not deleted.

The object cannot be deleted.

241

Maximum array size exceeded

There are too many elements in the array.

500

Internal server error

Internal server error. Try calling the method again later. If the error persists, contact the support service.

501

Invalid request

Invalid request to the Yandex Direct API.

503

Service temporarily unavailable

The Yandex Direct API server is temporarily unavailable.

504

A scheduled interruption in the server's operation. Repeat the request later

Extremely rare situation.

506

Simultaneous requests limit exceeded

You have reached the maximum number of simultaneous connections to the Yandex Direct server.

508

The requested API version is not available

This version of the API is outdated and is no longer supported. Use the most recent version of the Yandex Direct API.

509

This method is not available in this API version

This method call is not available in the version of the Yandex Direct API you are using.

510

Access denied

API access is forbidden.

511

Unknown language

An unknown locale was specified.

512

Invalid request method

Request was made using a method other than HTTP POST. Requests to Yandex Direct must be made using the HTTP POST method.

513

Your login is not enabled for Yandex Direct

514

Internal server error. Please contact the support service.

Error codes when working with budget forecasts and keywords

72

Invalid ForecastID

Invalid forecast request number (ForecastID parameter).

73

The specified budget forecast report does not exist

A budget forecast with the specified ID has not been created.

74

Forecast report is being generated

Compilation of the budget forecast is not yet complete.

76

Invalid keyword

A budget forecasting keyword is specified incorrectly (keywords parameter).

77

Invalid GeoID

Regions for displaying ads are specified incorrectly (GeoID parameter).

78

Report temporarily unavailable

91

The specified wordstat report does not exist

Invalid report ID (ReportID parameter). Check whether a report with this ID is in the list of requested reports.

92

Wordstat report is being generated

Compilation of the keyword report is not yet complete.

93

Invalid WordstatReportID

Invalid format for the ReportID parameter; for example, the value is not defined or contains symbols.

Error codes when working with campaigns, groups, ads, and keywords

26

The value must be between 0 and 100 in multiples of 10

The percent value is set incorrectly. Possible values: 0, 10, 20, ..., 100.

27

Invalid BannerID

The BannerID parameter is set incorrectly.

28

Invalid PhraseID

The PhraseID parameter is set incorrectly.

29

Invalid campaign type

You are not authorized to edit the specified campaign.

37

Invalid strategy parameters

You specified a forbidden combination of display strategies on search and in the Yandex Advertising Network, or a parameter was omitted that is required for the selected strategy.

39

Invalid ad ID

49

Invalid ad group ID

The AdGroupID parameter is set incorrectly.

111

Invalid campaign settings

The CampaignInfo data structure specified in the request has an incorrect format.

113

Invalid campaign filter parameters

Invalid filter values in the Filter parameter.

114

Exceeded limit on number of campaigns

See the restrictionsrestrictions.

151

Invalid banner settings

Incorrect format for the BannerInfo structure.

152

Not enough Yandex units

You do not have enough points on your account for this operation.

153

Maximum banner limit exceeded in request

The number of ads in the request is more than the maximum value.

154

Invalid PointOnMap structure

Incorrect coordinates given for the advertiser's location in the CreateOrUpdateBanners method call. The location is set in the ContactInfo -PointOnMap parameter.

155

This action cannot be performed on this campaign or ad

Attempt to perform archiving or extract an archive, starting, or stopping, when the campaign or ad is in a state that does not allow such an operation. For example, you tried to start a campaign that is in the archive.

156

Changes are not allowed in archived campaigns and ads

Attempt to change the parameters of a campaign or ad that is in the archive.

157

Exceeds the limit on ads per campaign

Attempt to create an ad group violating the restrictions.

158

Exceeds the limit on ads per group

Attempt to create an ad violating the restrictions.

192

Invalid negative keywords

Negative keywords incorrectly specified in the MinusKeywords parameter. Negative keywords should consist of valid characters that do not exceed the maximum length and do not constitute phrases.

193

Exceeded the maximum amount of 10,000 keywords

Exceeded the limit on the number of keywords per request.

194

Keyword not found

Invalid keyword ID was specified.

195

Group must contain a minimum of one active keyword or retargeting condition

Attempted to stop all active keywords in an ad (ad group) without any active retargetings.

245

Invalid currency value

The Currency parameter specifies a currency that does not match the currency of the campaign or is not available for the client (agency).

3500

Not supported.

Versions 4 and Live 4 of the Yandex Direct API fully support only campaigns, groups, and ads with the “Text & Image Ads” type. To work with all types of objects, use API version 5.

Error codes when updating bids

191

The ContextPrice for keywords active on search cannot be changed

The ContextPrice parameter is available for editing only in the following cases:

  1. When the MaximumCoverage strategy is selected for the Yandex Advertising Network.

  2. When the Default strategy is selected for the Yandex Advertising Network and the keyword is disabled on the search due to a low CTR.

    For new keywords this condition is irrelevant, since keywords are no longer disabled for a low CTR.

242

Invalid price

The CPC for a keyword is set incorrectly in the UpdatePrices or CreateOrUpdateBanners method.

243

Invalid Autobroker value

The AutoBroker attribute is set incorrectly (CreateOrUpdateBanners, GetBannerPhrases, UpdatePrices).

244

No keywords found

The SetAutoPrice (Live) method could not update bids because none of the keywords meet the selection conditions, or bids cannot be changed manually because an automatic bid management strategy is selected.

Error codes when working with clients

251

Invalid user login

The specified campaign owner login is incorrect (GetCampaignsList).

252

Login occupied

The login name is already in use by another Yandex user.

253

An error occurred while creating login

The client account could not be created using the CreateNewSubclient method. The specified login is in use.

254

An error occurred while creating client

The client account could not be created using the CreateNewSubclient method. The cause of the error is unknown.

255

Client cannot be linked to agency

The client account could not be created using the CreateNewSubclient method.

256

The specified agency does not exist

257

The user's rights cannot be updated

258

An error occurred while creating client

259

This client does not exist

You must first register the client using the CreateNewSubclient method.

518

Currency not available for the agency

Attempt to register an agency client in a currency that the agency is not able to make payments in.

Error codes when working with finance methods

350

Invalid financial transaction token

Invalid finance token (see Accessing finance methods).

351

Invalid transaction number

The specified transaction number is either less than or equal to the number of the previous financial transaction (see Accessing finance methods).

352

Financial transactions are not permitted for your account

Access to financial operations is disabled in the Yandex Direct web interface (see Accessing finance methods).

353

Invalid money transfer request

Invalid request input data: invalid campaign number, the amount of funds being deducted is not equal to the amount being credited, funds are being transferred between campaigns in different currencies, and so on. Additional information is provided in the error message.

354

Invalid invoice request

Invalid input data, or an error occurred in the API, or there are financial restrictions on payment. For example, funds cannot be added to the same campaign multiple times in the same request; funds cannot be added to the shared account by a direct advertiser if there is not a single moderated campaign. Additional information is provided in the detailed error description.

355

Credit limit exceeded

The payment amount exceeds the amount of available credit.

356

Invalid contract ID

The client does not have a credit agreement with the specified number.

357

Invalid campaign payment request regarding credit limits

Invalid input data, or there are financial restrictions on payment, or an error occurred in the API. Additional information is provided in the detailed error description.

358

Financial transactions are temporarily unavailable

The finance methods are temporarily unavailable due to technical issues in the API.

359

A MasterToken does not exist for this client

The master token was not issued in the Yandex Direct web interface (see Accessing finance methods

363

Overdraft unavailable

Overdraft cannot be used because the terms in the Service OfferService Offer have not been met (items 6.6–6.10).

364

Overdraft limit exceeded

The payment amount exceeds the available overdraft limit. To find out the overdraft limit, use the GetClientInfo (Live) method (OverdraftSumAvailable parameter).

366

Campaigns with different types can't be paid for in the same request.

Error codes for retargeting settings

46

Invalid retargeting ID

The specified retargeting ID does not exist.

47

Invalid retargeting condition ID

The specified retargeting condition does not exist.

Error codes when working with images

271

Image not found

The hash specified for the image does not exist.

272

Invalid image

The image cannot be uploaded: the image is not available at the given link, has an invalid format, or there is another problem with the image.

273

Image pool size exceeded

The image cannot be uploaded because you have reached the limit for the number of uploaded images and tasks in the upload queue for this advertiser.

274

Error when saving a file

Error codes when working with the shared account

515

Shared account must be connected

Attempt to get information about the shared account for an advertiser that does not have the shared account enabled.

517

Cannot update information for this AccountID

An internal error occurred when changing information for the shared account.

518

Currency not available for the agency

519

Shared account already connected

Attempt to enable the shared account for an advertiser who already has the shared account enabled.

520

To enable the shared account, create at least one campaign

The shared account cannot be enabled if the advertiser does not have a single campaign.

8305

Can't perform action

Attempt to change the daily budget amount more than 3 times during the same day.

WarningCode

WarningString

Description

Explanation

208

Existing retargeting condition was updated

Contains the id field, which is the ID of the updated retargeting object.

When attempting to add a retargeting condition that already exists in the group, the retargeting parameters are updated, but a new retargeting condition is not added.

209

The bid for the retargeting condition was ignored because Autobudget is enabled

Contains an empty structure.

Attempted to set the value of the ContextPrice retargeting parameter when using an automatic display strategy.

210

Condition was not added. Group already contains the specified condition

Not passed.

The input array for the Retargeting (Live) method (Add action) passes several retargetings with identical conditions for the same group. In this case, only one retargeting is created, and its parameters are taken from the last item in the input array.

211

The condition ID RetargetingConditionID was ignored

Not passed.

In the input array for the Retargeting (Live) method (the Update operation), the RetargetingConditionID parameter was passed. This parameter is ignored.

Warning codes when working with keywords

212

Keyword already stopped

Contains an empty structure.

When trying to stop impressions for a keyword that has already been stopped, nothing happens.

213

Keyword not stopped

Contains an empty structure.

When trying to restart impressions for a keyword that has not been stopped, nothing happens.