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 templateType parameter.

-6

Maximum allowed referrers 5

Exceeded the number of template lines for targetingUrlOn or targetingUrlOff. A maximum of 5 lines is allowed.

-6

Value for 'placeId' is required

The placeID, siteID or zoneID parameter isn't specified or is equal to 0.

-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 userID parameter.

-15

Invalid type

Invalid data type:

  • When the object passed is different from an array (for example, a string for OKVED codes instead of an array).
  • Invalid JSON for media data.

The parameter name is added to the <parameter> tag and the parameter value to the <value> tag. The response will also contain the maximum and minimum values.

-16

Type required

Missing the required type parameter for the banner placement setting. Add the type parameter that determines the placement logic (on a site or in an ad network).

-99

Multiple errors

When adding a backup ad for a banner type or placement, no value was specified for the image URL (defaultImageURL) or click-through URL (defaultHitURL) parameter.

-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 objectID and listIDs parameters.

-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 (isIms=1).

-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 sendToErir=1, a custom token is generated in the creative.

-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.