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
Error codes when working with statistics
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 restrictions.
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 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.

Warnings

WarningCode WarningString Description Explanation
Warning codes for retargeting settings
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.