Error Codes

Please find below the full list of error messages returned by the API.

ErrorCode Description
1 Unknown error
1001 Incorrect login or password
1002 Your contract does not have access to the API. Please contact the Support centre for further information.
1003 Only available to customers who had DataExplorer enabled during this period.
1004 You do not have the required rights to access this site or this group. Please contact your account administrator.
1005 You are not authorised to access this site.
1006 The requested functionality is not working
1007 The login and/or password field is empty.
1008 You don’t have any access right to this API
1010 The items within “space” parameter (site, level 2 site or group of sites) didn’t exist during the selected reference period (P1)
1011 You cannot make calls on this API URL. For your information, only the “period”, “max-result”, “lng” and “sep” parameters can be modified.
1012 One of the requested sites does not have access to the Data Explorer option, or is not part of the sites you are permitted to consult
1013 You do not have access to the Access Rights application.
1014 You do not have access to the requested group.
1017 You have entered an incorrect email address or password 5 times. Please try again in 30 seconds.
1019 Access refused: Your IP address is invalid
1020 A specific account option must be enabled to make this API call
1021 Password reset has expired. Please request to reset your password again.
1024 This contract/site has no admin
1617 The external OAuth connection has expired
2001 The URL contains an unknown parameter.
2002 Unknown shortcode.
2003 The “site” parameter is obsolete when using API v2. Please use “space”.
2004 The date must be in the format YYYY-MM-DD. It is also possible to use YYYY-MM-DDThh (hour) or YYYY-MM-DDThh:mm (minute) but only for real-time/offline periods.
2005 The date must be in the format YYYY-MM-DD. It is also possible to use YYYY-MM-DDThh (hour) or YYYY-MM-DDThh:mm (minute) but only for real-time/offline periods.
2006 The columns parameter contains one or more of the following errors: the syntax is incorrect, the number of columns exceeds 30, the columns only contain dimensions or 2 of the columns contain the same content.
2007 The “page-num” parameter must be a positive integer.
2008 Incorrect “Segment” parameter. A positive integer is required.
2009 The “max-results” parameter is compulsory whenever the “page-num” parameter has been filled-in. It must be between 1 and 10,000.
2010 Error for the “sort” parameter: it contains a syntax error (e.g. &sort={-d_geoloc_country}) or it contains an item that doesn’t exist in the “columns” parameter.
2011 Real-time data cannot be added to data from a previous period.
2012 The requested period cannot contain a date in the future and must be complete (please use the relative period to get current week ou current month)
2013 The end date must occur after the start date.
2014 The “sep” parameter cannot be used with the JSON format and only accepts the values: DOT or COMMA.
2015 The “lng” parameter has been entered incorrectly. Expected values: FR, EN, DE, ES, PT or RU
2016 The “Period” parameter is incompatible with the “start” and “end” parameters
2017 The “period” parameter contains a syntax error.
2018 The period is incorrect; it contains several offline days or it comprises non-offline and offline days.
2019 The number of non-consecutive periods in the “period” parameter exceeds the authorised limit of 30
2020 The “Include” parameter contains unknown attributes.
2021 The use of the evolution with the “sub:{}” function in the “columns” parameter is incorrect.
2022 Multi-period has been used incorrectly. Please consult the documentation for further information on its usage limits.
2023 The variation request (dif{} or var{}) is incorrect. Several periods must be declared and they cannot involve “Time”-type dimensions.
2024 Totals or references cannot be used in evolution mode.
2025 The “Space” parameter is incorrect.
2026 The “hidden” attribute in the “Columns” parameter has been used incorrectly.
2027 The use of the “Sample” parameter is incorrect. Only these values are possible: 1, 10, 100 or “auto”
2028 The “Ratio{}” function in the “Columns” parameter has been used incorrectly. It must follow the order of reference metric, then the desired type of total.
2029 The “evo” parameter has been used incorrectly. The reasons could be: the variables used in this parameter or the number of rows requested (<30), the granularity (< that of the period) or type of dimensions (no date, independent).
2030 The multi-spaces have been used incorrectly. They can only work with just 1 period and the dimensions called must exist on all of the declared spaces.
2031 The “extract” parameter is not in the right format. Only positive integers are accepted.
2032 A request involving several sites cannot be made for the current day (real time).
2033 A request involving several sites cannot be made for an offline day.
2034 The “segmentdesc” parameter is not used correctly.
2035 The “retention” parameter is being used incorrectly. The “p” variable must contain the desired granularity, the “v” variable (optional) must contain the data type, and the “nb” variable must contain the number of columns (limited based on the chosen granularity)
2036 The analysed period is not compatible with the requested cohort segment’s period. Please select another analysis period, or another segment.
2037 Use of this segment requires the “segmentdesc” parameter to be present in the URL
2038 Inconsistency between the “period” and “retention” parameters. They must have the same granularity (Day, Week or Month) and cannot involve the current period.
2039 The “retention” parameter cannot be used with a segment related to “visits”. Please delete the segment, or change it.
2040 The “segment” parameter is mandatory when the “segmentdesc” parameter is filled in with the “l2s:auto” space
2041 When filled in with the “l2s:auto” space, the “segmentdesc” parameter is not compatible with visitor segmentation
2042 The “Level 2” space must be filled in in the URL when the “segmentdesc” parameter is specified with “l2s:auto”
2043 A “date”-type dimension cannot be used with multiple periods
2044 When using several periods, the number of elements is limited to 100
2102 One of the custom metrics or the custom dimension is not available on this site.
2103 This segment is not available for this site.
2104 The requested segment does not exist, or it was closed.
2105 The “filter” parameter contains a syntax error or uses a forbidden operator within a hidden column.
2107 One of the metrics (“Unique visitors” or other) is only available per week or per month (must be a completed period). Please modify the requested period accordingly.
2108 This call requires special storage in order to facilitate data pre-calculation. To create this special storage, please save your call in template format in Data Query.
2109 Time-related dimensions (date, week, month, etc.) cannot be filtered. Please use the calendar to obtain the desired periods.
2110 One of the metrics in the API call (unique visitors or other) requires the “Month (time)” or the “Week (time)” dimension for a period exceeding 45 days: Please add one of these dimensions.
2111 One of the requested dimensions or metrics is not available for this site, which is classified as offline.
2112 One of the request variables contains several versions for the period. It is not possible, in this case, to call more than 45 consecutive days.
2113 It is not possible to apply a visitor segment to a real-time period.
2114 Your request involves several sites: only certain dimensions or metrics are available. Please consult Data Query > Groups > AT Internet templates to see which calls are authorised.
2115 The group ID in the Space parameter either does not exist or does not belong to you.
2116 One of the requested metrics is not authorised in this context.
2117 This REST API call cannot be made because the associated query is too long.
2118 It’s not possible to use both “Visitors (all)” and “Unique Visitors” metrics in the same API call.
2119 The retention matrix is not available for this site.
2120 The requested URL has not been set up in the DataFlow interface.
2121 The API call is not recognised, or contains an analysis that no longer exists.
2202 We’re unable to get the last minute of available data.
3002 The requested analysis period is too long. Please reduce the window of time for this analysis.
3003 The data is not yet available. It is either currently being processed, or relates to a period too far in the past.
3004 The data is limited to 31 days.
3005 One of the dimensions in your call requires very fine granularity, and therefore cannot be aggregated. In this case, the maximum authorised period is 45 days. Please select a shorter period, or remove the detailed dimension(s).
3006 Calls from Data Query on precalculated data are limited to periods of 6 months.
3007 Your request is pending calculation. Please try your call again later to check the progress of your request.
3008 Your request may take a particularly long time to calculate. The result will be visible as soon as the background calculation has finished.
3009 Your request was not able to be completed, for unknown reasons. Please try again later.
3010 This call cannot be executed in Data Query: The execution time is deemed too long, and it contains a dimension or metric prohibiting precalculation. Please remove the dimension(s) in question or shorten the analysis period.
3011 Custom data storage is currently being built. Your analyses will be available starting tomorrow (on condition that data exists)
3012 The parameter “segmentdesc” cannot be used with the “Unique Visitors” metric (or a custom metric based on this metric)
4000 Resource not found
4001 These dimensions and/or metrics are not compatible.
4002 One of the requested dimensions or metrics in the “columns”, “sort” or “filter” parameters does not exist.
4003 A segment cannot be used if one of the custom metrics contains a segment.
4004 This cross-correlatated information is not available in this context (data from before August 1, 2012, or a specific call like Data Flow)
4005 Time out. The request cannot be processed.
4007 Invalid call content
4008 Resource not found
4009 Time out. The request cannot be processed.
4010 The entered password is not in the correct format
4011 Sampling mode is not allowed for level 2 sites, nor for groups of sites.
4012 One of the custom metrics cannot be accessed in this context.
4013 A custom metric can be made up of 4 custom metrics maximum.
4015 Time out. The request cannot be processed.
5001 You have exceeded the number of simultaneous calls allowed. Please wait a moment and try again.
5002 Unimplemented method
5003 IQY file not found
5004 The maximum number of simultaneous calls has been reached. Please repeat the call later.
5005 An error has occured, thereby blocking this call. Please wait 10 minutes before trying again.
5007 The maximum number of flows has been reached.
5008 Service temporarily unavailable
5016 The requested connection does not exist.
5017 Non-specified or erroneous parameter
5021 You must specify a document ID.
5022 You must specify at least one recipient (user ID).
5023 The requested document does not exist.
5024 The performance of your query cannot be measured
5025 The requested dashboard contains a box with no dataset.
7101 This campaign cannot be modified because it has already created traffic.
7200 Unknown source site
7201 Missing destination site
7202 Missing setup of source site
7203 The destination site setup is not blank
7204 Configuration error
7205 The source site cannot appear as a destination site
7208 The source site must have site custom variables.
7302 This name already exists
7307 The site is already enabled
7400 This news does not exist.
7402 The news type is mandatory.
7403 The title and description in English are mandatory.
7404 The publication’s start date is mandatory.
7405 The publication end date cannot be before the start date.
7406 The publication’s end date is mandatory.
7500 Either this user doesn’t exist, or you don’t have the rights to consult him/her.
7503 The entered email already exists.
7505 A name is required for this configuration.
7506 An application must be selected.
7507 At least one site must be selected.
7508 At least one user must be selected.
7509 The name of the group of users is not defined
7510 The specified group is not valid
7513 The user already belongs to an organisation.
8001 No information available on this API account
8002 This custom metric cannot be deleted because it is used in a template, a segment or in another custom metric
8003 End date is earlier than the start date
8004 This segment cannot be deleted because it is used in a template or in a custom metric.
8005 You may not change the site, as one or several URLs are already associated with another site
8007 Invalid domain name
8008 The site URL must be identical to the site declared in the API account
9001 The requested version of this SDK is not available.
10002 This ID already exists, or is reserved for use in an automatic campaign.
10005 undefined SiteID
10007 The custom source does not exist
10008 A campaign cannot be backdated.
10009 The end date must be later than the start date
12001 This configuration cannot be deleted because it is in use.
17626 Multi-site requests are not authorised for offline sites.
255001 Maintenance is currently underway; the interface is therefore unavailable during this time. We apologise for the inconvenience.

Was this post helpful?

Last update: 07/11/2017