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 object. Check the context name. |
|
-4 |
Invalid action object name |
Incorrect actionObject. Check the name of the object that the action is performed on. |
|
-5 |
Invalid action name |
Incorrect action. Check the action name. |
|
-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 |
This object is placed upper |
A warning when you enable or disable a placement: the object is enabled in the placement at a higher level. |
|
-10 |
This object is unplaced upper |
A warning when you enable or disable a placement: 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 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 |
Missing the required |
|
-99 |
Multiple errors |
When adding a backup ad for a banner type or placement, no value was specified for the image URL ( |
|
-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 click-throughs. |
|
-1420 |
Cumulative amount of views should be set. |
Set the total number of impressions. |
|
-1420 |
Cumulative amount of clicks should be set. |
Set the total number of click-throughs. |
|
-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, 2 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 ad 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 ad campaign. Check the ID of the campaign that you want to edit. |
|
-1507 |
CPM is required |
Specify CPM. |
|
-1508 |
CPC is required |
Specify CPC. |
|
-1509 |
CPV is required |
Specify CPV. |
|
-1510 |
CPM is not allowed |
You can't use a CPM. |
|
-1511 |
Request contains too many "cost per" fields (CPM/CPC/CPV) |
The request contains too many cost-per-unit fields (CPM/CPC/CPV). |
|
-1512 |
Target CPC is required |
Specify a target CPC. |
|
-1513 |
Minimum VTR is required |
Specify a minimum VTR. |
|
-1514 |
You cannot specify the minimum CTR with CPC |
Can't specify a minimum CTR using a CPC. |
|
-1515 |
You cannot specify the minimum CTR with CPV |
Can't specify a minimum CTR using a CPV. |
|
-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 ad campaigns for monetizers is also prohibited. |
|
-1523 |
Too many "cost per" fields (CPM/CPC/CPV) greater then zero |
The request contains multiple cost fields for an action. |
|
-1524 |
You must specify at least one "cost per" field (CPM/CPC/CPV) |
Set a value for at least one cost-per-unit field (CPM/CPC/CPV). |
|
-2000 |
Advertiser is not assigned for current assistant. |
The assistant can't work with this advertiser. Change 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 or Latin letters and an underscore character. You can't use Cyrillic letters, spaces, quotation marks, hyphens, and special characters in the file name. |
|
-10105 |
Too long html field. |
The HTML code can't be longer 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 advertising campaign. |
|
-20002 |
The contract not found. |
No contract was found. |
|
-20003 |
The customer not found. |
No customer was found. |
|
-20004 |
The executor not found. |
No contractor was found. |
|
-20005 |
The intermediary contract not found. |
No parent contract was 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 cannot be empty. |
The parent contract ID must be specified for this contract. |
|
-20008 |
The contract cannot be deleted because it is linked to a campaign. |
Can't delete the contract because it is linked to a campaign. |
|
-20009 |
The contract cannot be deleted because it is linked to a supercampaign. |
Can't delete the contract because it is linked to a supercampaign. |
|
-20010 |
The contract cannot 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 |
Cannot delete the "Executor" role. There are sites associated with this executor. |
The “Executor” role cannot be deleted. There are sites associated with this contractor. |
|
-20012 |
Cannot delete the "Executor" role. There are contracts associated with this executor. |
The “Executor” role cannot be deleted. There are contracts associated with this contractor. |
|
-20013 |
Cannot delete the "Customer" role. There are contracts associated with this customer. |
The “Customer” role cannot be deleted. There are contracts associated with this contractor. |
|
-20014 |
The contractor cannot be deleted because it is linked to contracts. |
You cannot delete a contractor there are valid contracts with. |
|
-20015 |
The contractor cannot be deleted because it is linked to sites. |
You cannot delete the contractor. There are sites associated with them. |
|
-20040 |
INN is duplicated |
A contractor with this INN (Taxpayer ID) already exists. |
|
-20042 |
Incorrect conclusion date (the date must be greater than 1991.01.01 and not older than the current date) |
Invalid date of the contract or additional agreement. The date must be not earlier than 1991/01/01 and not later than the current date. |
|
-20050 |
Token field is not allowed when sendToErir=1 |
You can pass a third-party token only when data submission to the state register (ERIR) is disabled. If |
|
-20051 |
Invalid third-party token (letters and numbers only allowed) |
Invalid third-party token (only Latin letters and numbers are allowed). |
|
-20072 |
AMOUNT_CANT_BE_EMPTY |
The amount of a paid contract can't be zero. |
|
-20073 |
AMOUNT_SHOULD_BE_EMPTY |
The contract amount must be zero. |
|
-20074 |
CANT_CHANGE_SOCIAL_TYPE |
Can't change the type of social advertising because the contract has associated invoices. |
|
-20075 |
CHARGE_PAID_BY_AGENT |
The “Paid by the intermediary” attribute can only be set in an intermediary contract where the intermediary represents the advertiser. |
|
-20076 |
HAS_INVOICE_REF_CANT_CHANGE_ROLE |
Can't change the contract role (there are associated invoices). |
|
-20077 |
HAS_CAMPAIGN_REF_CANT_CHANGE_ROLE |
Can't change the contract role (there are associated campaigns). |
|
-20078 |
Intermediary contract id must be empty in not additional agreement contracts |
If the main contract is selected in a contract that isn't an additional agreement. |