{"id":1574,"date":"2019-11-28T11:12:17","date_gmt":"2019-11-28T11:12:17","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=1574"},"modified":"2026-09-03T15:26:36","modified_gmt":"2026-09-03T15:26:36","slug":"appendix-errors","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/appendix-errors\/","title":{"rendered":"appendix\/errors"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Errors<\/h2>\n

[\/vc_column_text][vc_column_text]<\/p>\n

This endpoint returns a list of possible DataForSEO API errors and general status codes. Below you will find a list of HTTP response codes and internal messages. We recommend storing the data connected to error codes in your application log and designing a necessary system for handling related exceptional or error conditions.<\/p>\n

Note:<\/strong> DataForSEO API servers always return the 200<\/code> HTTP response code, except for the following cases.<\/p>\n

HTTP response codes:<\/strong><\/p>\n\n\n\n\n\n\n\n\n
Code<\/th>\nMessage<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
401<\/code><\/td>\nUnauthorized<\/td>\nYou are not authorized to access this resource. See your login details here: https:\/\/app.dataforseo.com\/api-access<\/em><\/td>\n<\/tr>\n
402<\/code><\/td>\nPayment Required<\/td>\nWe had a problem billing your account. Please, check your account’s balance.<\/em><\/td>\n<\/tr>\n
404<\/code><\/td>\nNot Found<\/td>\nRequested endpoint not found<\/i><\/td>\n<\/tr>\n
500<\/code><\/td>\nInternal Server Error<\/td>\nSorry, we could not process your request due to the internal server error. Please, try again later.<\/i><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Alongside the 200<\/code> HTTP code, our system also generates internal status codes which you may find in status_code<\/code> and status_message<\/code> fields of the API response.<\/p>\n

Note:<\/strong> status messages can be expanded in the API response and may vary depending on the event that triggered them.<\/p>\n

Internal status codes and messages: <\/strong>
\n

Field name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
20000<\/code><\/td>ok.<\/td>

the request has been successfully completed<\/p><\/td><\/tr>

20100<\/code><\/td>task created.<\/td>

as a result of the successful request, the task has been created<\/p><\/td><\/tr>

40000<\/code><\/td>you can set only one task at a time.<\/td>

you cannot specify more than one task in the POST array<\/p><\/td><\/tr>

40001<\/code><\/td>this id is used by another client, check the id.<\/td>

the task identifier id<\/code> is unique to the client used to send the request<\/p><\/td><\/tr>

40002<\/code><\/td>this id is used by another search engine, check the path.<\/td>

the task identifier id<\/code> is unique to the search engine used in the URL path of the request<\/p><\/td><\/tr>

40003<\/code><\/td>this id is used by another search type, check the path.<\/td>

the task identifier id<\/code> is unique to the search type used in the URL path of the request<\/p><\/td><\/tr>

40004<\/code><\/td>this id is used by another function, check the id.<\/td>

the task identifier id<\/code> is unique to the function used in the URL path of the request<\/p><\/td><\/tr>

40006<\/code><\/td>you can set no more than 100 tasks at a time.<\/td>

each POST request can contain up to 100 tasks<\/p><\/td><\/tr>

40100<\/code><\/td>you are not authorized to access this resource. see your login details here: https:\/\/app.dataforseo.com\/api-dashboard .<\/td>

check if the specified credentials match those in your account dashboard<\/a><\/p><\/td><\/tr>

40101<\/code><\/td>internal se server error.<\/td>

the requested search engine was unable to process your request and responded with an error;
learn more on our help center<\/a><\/p><\/td><\/tr>

40102<\/code><\/td>no search results.<\/td>

no results matching the details of your request have been found;
learn more on our help center<\/a><\/p><\/td><\/tr>

40103<\/code><\/td>task execution failed, please try to resubmit the task.<\/td>

the task could not be executed, try posting another task with similar parameters<\/p><\/td><\/tr>

40104<\/code><\/td>please verify your account before using the api. you can complete the verification in the user panel: https:\/\/app.dataforseo.com\/ .<\/td>

email and\/or phone verification is required for new users; to use DataForSEO APIs, you have to complete the account verification process in the User Panel<\/a><\/p><\/td><\/tr>

40105<\/code><\/td>The task was deleted and is no longer available.<\/td>

the task that you are referring to has been deleted from our system<\/p><\/td><\/tr>

40106<\/code><\/td>Task completed with partial results. Some pages could not be retrieved after several retry attempts. You have not been charged for the pages that were not returned.<\/td>

the task has been completed successfullt, but we could not parse some of the requested results;
for example, if you set a task to retrieve 100 SERP results, but we only parsed 80 results \u2014 you will get 80 results with this error, without being charged for the remaining 20 unparsed results<\/p><\/td><\/tr><\/tbody><\/table><\/div>
\nYou can also get the list of internal error codes by calling the ‘Errors’ endpoint:<\/strong>
\n\t

\n\t\t
\n\t\t\t
\n\t\t\t\t\n\t\t\t\t\t<\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t
Pricing<\/div>\n\t\t<\/header>\n\t\t
\n\t\t\t

Your account will not be charged for using this API<\/p>\n\t\t<\/div>\n\t<\/article>\n\t

\n \"checked\"\n\n GET