Error handling
If there's an error
tag in the response, it means an error occurred when processing the request. You need to correct the request and repeat it.
Sample error response:
-
As a simple structure.
<response> <status> <code>-2</code> <error>Access denied</error> </status> </response>
-
With additional information about the incorrect parameter.
<response> <status> <code>-6</code> <error>Incorrect value</error> <parameter>encoding</parameter> <value>123</value> </status> </response>
A request may be partially executed. In this case, the response contains the <code>0</code>
tag and the message
tag describing the part of the request that hasn't been executed.
See the error code key in the table:
Code |
Error |
Key |
-1 |
Authorization failed |
Authorization error. Check whether the login and password are correct. The password must be passed as the value of the sha256 hash function from the user's password. |
-2 |
Access denied |
Access to the object is denied. You don't have enough access rights. |
-2 |
Change targeting by URL is not allowed |
You don't have access to editing targeting by URL. |
-3 |
Invalid object name |
Incorrect |
-4 |
Invalid action object name |
Incorrect |
-5 |
Invalid action name |
Incorrect |
-6 |
Incorrect value |
Incorrect parameter value. Check the parameter value. |
-6 |
Type 3 is not allowed |
An invalid URL template type is set for the |
-6 |
Maximum allowed referrers 5 |
Exceeded the number of template lines for |
-6 |
Value for 'placeId' is required |
The |
-7 |
Value required |
A required parameter isn't set. Check whether the request contains all required parameters. |
-8 |
Account already exists |
The account already exists (the error is displayed when you create or rename an account). Try entering a different account name. |
-9 |
Value must be not NULL |
The parameter can't be empty. Specify the parameter value. |
-10 |
A warning when you enable or disable a placement: |
|
-10 |
This object is placed upper |
The object is enabled in the placement at a higher level. |
-10 |
This object is unplaced upper |
The object is disabled in the placement at a lower level. |
-11 |
Error file uploading |
File upload error. Incorrect links to media data transmitted. The tag will contain the URL that the data could not be uploaded for |
-12 |
Value is out of length |
The maximum allowed length of the parameter value line has been exceeded. |
-14 |
Duplicate entry |
This identifier of the value of an additional characteristic or an action tracing point is already in use. Specify a different value for the |
-15 |
Invalid type |
Invalid data type:
The parameter name is added to the |
-16 |
Type required |
The required |
-99 |
Multiple errors |
When adding a backup ad for a banner type or placement, no value was specified for the |
-100 |
The maximum allowed file size has been exceeded. |
|
-101 |
Incorrect MIME type. |
|
-102 |
Internal error. |
|
-103 |
Internal error. |
|
-200 |
Couldn't load the file at the specified URL. |
|
-667 |
Logon errors limit reached |
The limit of authorization errors has been reached: 7 incorrect attempts were made in the last 5 minutes. You need to check the authorization data and try again after 10 minutes. |
-680 |
Connection limit reached |
The maximum number of concurrent requests was exceeded. Repeat the request later. |
-999 |
Http is not allowed |
This type of request can't be executed over the HTTP protocol. Repeat the request over HTTPS. |
-1415 |
Daily amount of views should be set |
Set the daily number of impressions. |
-1416 |
Daily amount of clicks should be set |
Set the daily number of clicks. |
-1420 |
Cumulative amount of views should be set |
Set the total number of clicks. |
-1420 |
Cumulative amount of clicks should be set |
Set the total number of impressions. |
-1500 |
Only marked as "For insertion code with context.js" banners can be added in campaign with Impression method "Viewable impression, 2 seconds". |
If a campaign uses “Viewable impression, 2 seconds” as the impression count method, only banners with templates that have the [context] tag in their name can be added to the campaign. |
-1501 |
Banners do not match the campaign, or they are deleted |
Banners required for copying weren't found in the specified campaign, or they were deleted. Check the values for the |
-1502 |
Only banners with templates marked as "For insertion code with context.js" is allowed to add in this campaign |
If a campaign uses “Viewable impression, two seconds” as the impression count method, only banners with templates that have the [context] tag in their name can be copied to the campaign. |
-1504 |
Campaign kind is not dynamic allocation |
Can't determine CPM because the campaign type isn't Dynamic monetization. Change the campaign type and repeat the CPM change. |
-1505 |
Dynamic allocation is not enabled |
The “Dynamic monetization” module isn't enabled in the account. Contact support to enable the module. |
-1506 |
CPM is blocked in system campaigns |
Can't change the CPM for a system campaign. Check the ID of the campaign that you want to modify. |
-1507 |
To change the CPM, you need to wait 5 minutes. Please wait 5 minutes. |
Repeat the CPM change request after 5 minutes. |
-1508 |
Incorrect JSON format in "blocks" field |
The JSON value is described incorrectly, or there's no |
-1516 |
Can not copy campaigns or banners with external monetization |
Campaigns and banners created for external monetizers (such as criteo, Soloway, mytarget, and others) can't be copied. Copying banners from campaigns for monetizers is also prohibited. |
-2000 |
Advertiser is not assigned for current assistant |
The assistant can't work with this advertiser. You need to either manage the assistant's permissions, or create a campaign with an advertiser that's available to the assistant. |
-2500 |
You should use IMS template in IMS campaign |
When you create a banner in a campaign with the IMS impression count method, you have to use IMS templates. Get a list of templates for the banner type and make sure that IMS is enabled in the template ( |
-10101 |
File size limit reached |
by default, the maximum file size is 300 KB. The maximum video size is 1 MB. |
-10103 |
Wrong file type |
Invalid file type in the archive. Allowed file types: CSS, JS, HTML, GIF, PNG, JPG, JPEG, SVG, JSON, FLV, MP4, OGV, OGG, WEBM, AVI, SWF, OTF, TTF, ABF, ACFM, GDR, ETX, EOT, FNT, FON, MF, TTC, and WOFF. |
-10104 |
Wrong file name |
File names must only contain numbers, Latin letters, or an underscore. You can't use Cyrillic letters, spaces, quotation marks, dashes, and special characters in the file name. |
-10105 |
Too long html field |
The HTML code can't be more than 65,000 characters. |
-10105 |
Unsupported archive type |
The archive type is unsupported. You can only use a ZIP archive. |
-10106 |
Must be one html file in archive |
The project can contain only one file with the HTML extension. |
-10108 |
Files depth limit reached |
The file nesting depth has been exceeded. The maximum nesting level is 2. |
-20000 |
You need to specify the creative data |
Data about creatives was not transmitted or data could not be obtained from the transmitted parameters (for example, template creatives with no data are specified). |
-20001 |
The advertising campaign is not marked |
Can't enable the ad register for the banner, since it is disabled for the campaign. |
-20002 |
The contract not found |
The contract wasn't found. |
-20003 |
The customer not found |
The customer wasn't found. |
-20004 |
The executor not found |
The contractor wasn't found. |
-20005 |
The intermediary contract not found |
The parent contract wasn't found. |
-20006 |
The customer and the executor cannot be the same contractor |
The customer and the contractor cannot be the same counterparty. |
-20007 |
Intermediary contract id can not be empty |
The parent contract ID must be specified for this contract. |
-20008 |
The contract can not be deleted because it is linked to a campaign |
Can't delete the contract because it is linked to a campaign. |
-20009 |
The contract can not be deleted because it is linked to a supercampaign |
Can't delete the contract because it is linked to a supercampaign. |
-20010 |
The contract can not be deleted, because it has an additional agreement associated with it |
Can't delete the contract because there is an additional agreement associated with it. |
-20011 |
Can not delete role "Executor". There are sites associated with this executor |
The "Executor" role cannot be deleted. There are websites associated with this contractor. |
-20012 |
Can not delete role "Executor". There are contracts associated with this executor |
The "Executor" role cannot be deleted. There are contracts associated with the counterparty. |
-20013 |
Can not delete role "Customer". There are contracts associated with this customer |
The "Customer" role cannot be deleted. There are contracts associated with the counterparty. |
-20014 |
The contractor can not be deleted because it is linked to a contracts |
You cannot delete a contractor that there are valid contracts with. |
-20015 |
The contractor can not be deleted because it is linked to a sites |
You cannot delete the counterparty. There are websites associated with it. |
-20040 |
INN is duplicated |
A contractor with this INN already exists. |
-20042 |
Incorrect conclusion date (the date must be greater than 1991.01.01 and not older than the current date) |
A date of a contract/additional agreement is incorrect. The date must be greater than 1991.01.01 and not older than the current date. |
-20050 |
Token field is not allowed when sendToErir=1 |
You can pass a third-party token only when data submitting to the Russian state register is turned off. If the parameter is |
-20051 |
Invalid third-party token (letters and numbers only allowed) |
Incorrect third-party token (only Latin letters and numbers are allowed). |