Question:

Where can I get the List of Error Codes for Facebook's API?

 

 

Answer:

Appreciate if you can like this page if you find it useful! - Click "Like"

Before the Facebook wiki is shut down, the error code list can be found there..... but now.... :(

I have reported this to Facebook already. Meanwhile, I have copied the list of error code from I obtained from the wiki page (http://wiki.developers.facebook.com/index.php/Error_codes) before:

****************************************************************************************

 

Each method call to the API may return an error instead of the expected result due to possible bugs in either the application's code or Facebook's servers. On this page, you can find all of the potential errors that could be returned, as well as the functions which can return them.

In the PHP client, these are thrown as exceptions. If you want to degrade gracefully, you will need to catch them appropriately.

 

Overview

If you pass in a malformed or invalid API request, an error result gets returned. This is detectable by checking if the root element is of type error_response. Within this element, an error code and explanatory message are returned, as well as all of the parameter names and values of the original request.

In the example below, we see the error returned when an otherwise-valid request is made from an unauthorized IP address

Example Return XML

<?xml version="1.0" encoding="UTF-8"?>
<error_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd">
<error_code>5</error_code>
<error_msg>Unauthorized source IP address (ip was: 10.1.2.3)</error_msg>
<request_args list="true">
<arg>
<key>method</key>
<value>facebook.friends.get</value>
</arg>
<arg>
<key>session_key</key>
<value>373443c857fcda2e410e349c-i7nF4PqX4IW4.</value>
</arg>
<arg>
<key>api_key</key>
<value>0289b21f46b2ee642d5c42145df5489f</value>
</arg>
<arg>
<key>call_id</key>
<value>1170813376.3544</value>
</arg>
<arg>
<key>v</key>
<value>1.0</value>
</arg>
<arg>
<key>sig</key>
<value>570dcc2b764578af350ea1e1622349a0</value>
</arg>
</request_args>
</error_response>


Error Code Table

General Errors

Errornumber PHP Constant name Error description Generated by methods
0 API_EC_SUCCESS Success (all)
1 API_EC_UNKNOWN An unknown error occurred (all)
2 API_EC_SERVICE Service temporarily unavailable (all)
3 API_EC_METHOD Unknown method
4 API_EC_TOO_MANY_CALLS Application request limit reached (all)
5 API_EC_BAD_IP Unauthorized source IP address (all)
6 API_EC_HOST_API This method must run on api.facebook.com (all)
7 API_EC_HOST_UP This method must run on api-video.facebook.com
8 API_EC_SECURE This method requires an HTTPS connection
9 API_EC_RATE User is performing too many actions
10 API_EC_PERMISSION_DENIED Application does not have permission for this action
11 API_EC_DEPRECATED This method is deprecated
12 API_EC_VERSION This API version is deprecated
13 API_EC_INTERNAL_FQL_ERROR The underlying FQL query made by this API call has encountered an error. Please check that your parameters are correct.
14 API_EC_HOST_PUP This method must run on api-photo.facebook.com
15 API_EC_SESSION_SECRET_NOT_ALLOWED This method call must be signed with the application secret (You are probably calling a secure method using a session secret)
16 API_EC_HOST_READONLY This method cannot be run on this host, which only supports read-only calls
17 API_EC_USER_TOO_MANY_CALLS User request limit reached
18 API_EC_REQUEST_RESOURCES_EXCEEDED This API call could not be completed due to resource limits

Parameter Errors

Errornumber PHP Constant name Error description Generated by methods
100 API_EC_PARAM Invalid parameter (all)
101 API_EC_PARAM_API_KEY Invalid API key (all)
102 API_EC_PARAM_SESSION_KEY Session key invalid or no longer valid (all)
103 API_EC_PARAM_CALL_ID Call_id must be greater than previous
104 API_EC_PARAM_SIGNATURE Incorrect signature (all)
105 API_EC_PARAM_TOO_MANY The number of parameters exceeded the maximum for this operation
110 API_EC_PARAM_USER_ID Invalid user id photos.addTag
111 API_EC_PARAM_USER_FIELD Invalid user info field
112 API_EC_PARAM_SOCIAL_FIELD Invalid user field
113 API_EC_PARAM_EMAIL Invalid email
114 API_EC_PARAM_USER_ID_LIST Invalid user ID list
115 API_EC_PARAM_FIELD_LIST Invalid field list
120 API_EC_PARAM_ALBUM_ID Invalid album id
121 API_EC_PARAM_PHOTO_ID Invalid photo id
130 API_EC_PARAM_FEED_PRIORITY Invalid feed publication priority
140 API_EC_PARAM_CATEGORY Invalid category
141 API_EC_PARAM_SUBCATEGORY Invalid subcategory
142 API_EC_PARAM_TITLE Invalid title
143 API_EC_PARAM_DESCRIPTION Invalid description
144 API_EC_PARAM_BAD_JSON Malformed JSON string
150 API_EC_PARAM_BAD_EID Invalid eid
151 API_EC_PARAM_UNKNOWN_CITY Unknown city
152 API_EC_PARAM_BAD_PAGE_TYPE Invalid page type
170 API_EC_PARAM_BAD_LOCALE Invalid locale
180 API_EC_PARAM_BLOCKED_NOTIFICATION This notification was not delieved
190 API_EC_PARAM_ACCESS_TOKEN Invalid OAuth 2.0 Access Token

User Permission Errors

Errornumber PHP Constant name Error description Generated by methods
200 API_EC_PERMISSION Permissions error
210 API_EC_PERMISSION_USER User not visible
211 API_EC_PERMISSION_NO_DEVELOPERS Application has no developers. admin.setAppProperties
212 API_EC_PERMISSION_OFFLINE_ACCESS Renewing a session offline requires the extended permission offline_access
220 API_EC_PERMISSION_ALBUM Album or albums not visible
221 API_EC_PERMISSION_PHOTO Photo not visible
230 API_EC_PERMISSION_MESSAGE Permissions disallow message to user
240 API_EC_PERMISSION_MARKUP_OTHER_USER Desktop applications cannot set FBML for other users
250 API_EC_PERMISSION_STATUS_UPDATE Updating status requires the extended permission status_update. users.setStatus
260 API_EC_PERMISSION_PHOTO_UPLOAD Modifying existing photos requires the extended permission photo_upload photos.upload,photos.addTag
261 API_EC_PERMISSION_VIDEO_UPLOAD Modifying existing photos requires the extended permission photo_upload photos.upload,photos.addTag
270 API_EC_PERMISSION_SMS Permissions disallow sms to user.
280 API_EC_PERMISSION_CREATE_LISTING Creating and modifying listings requires the extended permission create_listing
281 API_EC_PERMISSION_CREATE_NOTE Managing notes requires the extended permission create_note.
282 API_EC_PERMISSION_SHARE_ITEM Managing shared items requires the extended permission share_item.
290 API_EC_PERMISSION_EVENT Creating and modifying events requires the extended permission create_event events.create, events.edit
291 API_EC_PERMISSION_LARGE_FBML_TEMPLATE FBML Template isn\'t owned by your application.
292 API_EC_PERMISSION_LIVEMESSAGE An application is only allowed to send LiveMessages to users who have accepted the TOS for that application. liveMessage.send
293 API_EC_PERMISSION_XMPP_LOGIN Logging in to chat requires the extended permission xmpp_login Integrating with FacebookChat
294 API_EC_PERMISSION_ADS_MANAGEMENT Managing advertisements requires the extended permission ads_management, and a participating API key Ads API
296 API_EC_PERMISSION_CREATE_EVENT Managing events requires the extended permission create_event API#Events_API_Methods
298 API_EC_PERMISSION_READ_MAILBOX Reading mailbox messages requires the extended permission read_mailbox message.getThreadsInFolder
299 API_EC_PERMISSION_RSVP_EVENT RSVPing to events requires the extended permission create_rsvp events.rsvp

Data Editing Errors

Errornumber PHP Constant name Error description Generated by methods
300 API_EC_EDIT Edit failure
310 API_EC_EDIT_USER_DATA User data edit failure
320 API_EC_EDIT_PHOTO Photo edit failure
321 API_EC_EDIT_ALBUM_SIZE Album is full
322 API_EC_EDIT_PHOTO_TAG_SUBJECT Invalid photo tag subject
323 API_EC_EDIT_PHOTO_TAG_PHOTO Cannot tag photo already visible on Facebook
324 API_EC_EDIT_PHOTO_FILE Missing or invalid image file
325 API_EC_EDIT_PHOTO_PENDING_LIMIT Too many unapproved photos pending
326 API_EC_EDIT_PHOTO_TAG_LIMIT Too many photo tags pending
327 API_EC_EDIT_ALBUM_REORDER_PHOTO_NOT_IN_ALBUM Input array contains a photo not in the album
328 API_EC_EDIT_ALBUM_REORDER_TOO_FEW_PHOTOS Input array has too few photos
329 API_EC_MALFORMED_MARKUP Template data must be a JSON-encoded dictionary, of the form {\'key-1\': \'value-1\', \'key-2\': \'value-2\', ...}
330 API_EC_EDIT_MARKUP Failed to set markup
340 API_EC_EDIT_FEED_TOO_MANY_USER_CALLS Feed publication request limit reached
341 API_EC_EDIT_FEED_TOO_MANY_USER_ACTION_CALLS Feed action request limit reached
342 API_EC_EDIT_FEED_TITLE_LINK Feed story title can have at most one href anchor
343 API_EC_EDIT_FEED_TITLE_LENGTH Feed story title is too long
344 API_EC_EDIT_FEED_TITLE_NAME Feed story title can have at most one fb:userlink and must be of the user whose action is being reported
345 API_EC_EDIT_FEED_TITLE_BLANK Feed story title rendered as blank
346 API_EC_EDIT_FEED_BODY_LENGTH Feed story body is too long
347 API_EC_EDIT_FEED_PHOTO_SRC Feed story photo could not be accessed or proxied
348 API_EC_EDIT_FEED_PHOTO_LINK Feed story photo link invalid
350 API_EC_EDIT_VIDEO_SIZE Video file is too large video.upload
351 API_EC_EDIT_VIDEO_INVALID_FILE Video file was corrupt or invalid video.upload
352 API_EC_EDIT_VIDEO_INVALID_TYPE Video file format is not supported video.upload
353 API_EC_EDIT_VIDEO_FILE Missing video file video.upload
354 API_EC_EDIT_VIDEO_NOT_TAGGED User is not tagged in this video
355 API_EC_EDIT_VIDEO_ALREADY_TAGGED User is already tagged in this video
360 API_EC_EDIT_FEED_TITLE_ARRAY Feed story title_data argument was not a valid JSON-encoded array
361 API_EC_EDIT_FEED_TITLE_PARAMS Feed story title template either missing required parameters, or did not have all parameters defined in title_data array
362 API_EC_EDIT_FEED_BODY_ARRAY Feed story body_data argument was not a valid JSON-encoded array
363 API_EC_EDIT_FEED_BODY_PARAMS Feed story body template either missing required parameters, or did not have all parameters defined in body_data array
364 API_EC_EDIT_FEED_PHOTO Feed story photos could not be retrieved, or bad image links were provided
365 API_EC_EDIT_FEED_TEMPLATE The template for this story does not match any templates registered for this application
366 API_EC_EDIT_FEED_TARGET One or more of the target ids for this story are invalid. They must all be ids of friends of the acting user
367 API_EC_EDIT_FEED_MARKUP The template data provided doesn't cover the entire token set needed to publish the story
370 API_EC_USERS_CREATE_INVALID_EMAIL The email address you provided is not a valid email address
371 API_EC_USERS_CREATE_EXISTING_EMAIL The email address you provided belongs to an existing account
372 API_EC_USERS_CREATE_BIRTHDAY The birthday provided is not valid
373 API_EC_USERS_CREATE_PASSWORD The password provided is too short or weak
374 API_EC_USERS_REGISTER_INVALID_CREDENTIAL The login credential you provided is invalid.
375 API_EC_USERS_REGISTER_CONF_FAILURE Failed to send confirmation message to the specified login credential.
376 API_EC_USERS_REGISTER_EXISTING The login credential you provided belongs to an existing account
377 API_EC_USERS_REGISTER_DEFAULT_ERROR Sorry, we were unable to process your registration.
378 API_EC_USERS_REGISTER_PASSWORD_BLANK Your password cannot be blank. Please try another.
379 API_EC_USERS_REGISTER_PASSWORD_INVALID_CHARS Your password contains invalid characters. Please try another.
380 API_EC_USERS_REGISTER_PASSWORD_SHORT Your password must be at least 6 characters long. Please try another.
381 API_EC_USERS_REGISTER_PASSWORD_WEAK Your password should be more secure. Please try another.
382 API_EC_USERS_REGISTER_USERNAME_ERROR Our automated system will not approve this name.
383 API_EC_USERS_REGISTER_MISSING_INPUT You must fill in all of the fields.
384 API_EC_USERS_REGISTER_INCOMPLETE_BDAY You must indicate your full birthday to register.
385 API_EC_USERS_REGISTER_INVALID_EMAIL Please enter a valid email address.
386 API_EC_USERS_REGISTER_EMAIL_DISABLED The email address you entered has been disabled. Please contact disabled@facebook.com with any questions.
387 API_EC_USERS_REGISTER_ADD_USER_FAILED There was an error with your registration. Please try registering again.
388 API_EC_USERS_REGISTER_NO_GENDER Please select either Male or Female.

Authentication Errors

Error number PHP Constant name Error description Generated by methods
400 API_EC_AUTH_EMAIL Invalid email address
401 API_EC_AUTH_LOGIN Invalid username or password
402 API_EC_AUTH_SIG Invalid application auth sig
403 API_EC_AUTH_TIME Invalid timestamp for authentication

Session Errors

Errornumber PHP Constant name Error description Generated by methods
450 API_EC_SESSION_TIMED_OUT Session key specified has passed its expiration time
451 API_EC_SESSION_METHOD Session key specified cannot be used to call this method
452 API_EC_SESSION_INVALID Session key invalid. This could be because the session key has an incorrect format, or because the user has revoked this session
453 API_EC_SESSION_REQUIRED A session key is required for calling this method
454 API_EC_SESSION_REQUIRED_FOR_SECRET A session key must be specified when request is signed with a session secret
455 API_EC_SESSION_CANNOT_USE_SESSION_SECRET A session secret is not permitted to be used with this type of session key

Application Messaging Errors

Error number PHP Constant name Error description Generated by methods
500 API_EC_MESG_BANNED Message contains banned content
501 API_EC_MESG_NO_BODY Missing message body
502 API_EC_MESG_TOO_LONG Message is too long
503 API_EC_MESG_RATE User has sent too many messages
504 API_EC_MESG_INVALID_THREAD Invalid reply thread id
505 API_EC_MESG_INVALID_RECIP Invalid message recipient
510 API_EC_POKE_INVALID_RECIP Invalid poke recipient
511 API_EC_POKE_OUTSTANDING There is a poke already outstanding
512 API_EC_POKE_RATE User is poking too fast
513 API_EC_POKE_USER_BLOCKED User cannot poke via API

FQL Errors

Errornumber PHP Constant name Error description Generated by methods
600 FQL_EC_UNKNOWN_ERROR An unknown error occurred in FQL fql.query,fql.multiquery
601 FQL_EC_PARSER_ERROR Error while parsing FQL statement fql.query,fql.multiquery
602 FQL_EC_UNKNOWN_FIELD The field you requested does not exist fql.query,fql.multiquery
603 FQL_EC_UNKNOWN_TABLE The table you requested does not exist fql.query,fql.multiquery
604 FQL_EC_NO_INDEX Your statement is not indexable fql.query,fql.multiquery
605 FQL_EC_UNKNOWN_FUNCTION The function you called does not exist fql.query,fql.multiquery
606 FQL_EC_INVALID_PARAM Wrong number of arguments passed into the function fql.query,fql.multiquery
607 FQL_EC_INVALID_FIELD FQL field specified is invalid in this context. fql.query*,fql.multiquery
608 FQL_EC_INVALID_SESSION An invalid session was specified fql.query,fql.multiquery
609 FQL_EC_UNSUPPORTED_APP_TYPE FQL field specified is invalid in this context. fql.query*,fql.multiquery
610 FQL_EC_SESSION_SECRET_NOT_ALLOWED FQL field specified is invalid in this context. fql.query*,fql.multiquery
611 FQL_EC_DEPRECATED_TABLE FQL field specified is invalid in this context. fql.query*,fql.multiquery
612 FQL_EC_EXTENDED_PERMISSION The stream requires an extended permission fql.query,fql.multiquery
613 FQL_EC_RATE_LIMIT_EXCEEDED Calls to stream have exceeded the rate of 100 calls per 600 seconds. fql.query,fql.multiquery
614 FQL_EC_UNRESOLVED_DEPENDENCY Unresolved dependency in multiquery fql.multiquery
615 FQL_EC_INVALID_SEARCH This search is invalid fql.query,fql.multiquery
617 FQL_EC_TOO_MANY_FRIENDS_FOR_PRELOAD The user you queried against has too many friends to be used with Preload FQL, in order to avoid out of memory errors fql.query,fql.multiquery

* This error is returned when the field name is sometimes valid, but not all the time. For example, if you run fql.query on the Metrics FQL table, you can get this error because some metrics are queryable only over the daily period, as opposed to the weekly or monthly periods.

Ref Errors

Error number PHP Constant name Error description Generated by methods
700 API_EC_REF_SET_FAILED Unknown failure in storing ref data. Please try again.

Application Integration Errors

Errornumber PHP Constant name Error description Generated by methods
750 API_EC_FB_APP_UNKNOWN_ERROR Unknown Facebook application integration failure.
751 API_EC_FB_APP_FETCH_FAILED Fetch from remote site failed.
752 API_EC_FB_APP_NO_DATA Application returned no data. This may be expected or represent a connectivity error.
753 API_EC_FB_APP_NO_PERMISSIONS Application returned user had invalid permissions to complete the operation.
754 API_EC_FB_APP_TAG_MISSING Application returned data, but no matching tag found. This may be expected.
755 API_EC_FB_APP_DB_FAILURE The database for this object failed.

Data Store API Errors

Errornumber PHP Constant name Error description Generated by methods
800 API_EC_DATA_UNKNOWN_ERROR Unknown data store API error
801 API_EC_DATA_INVALID_OPERATION Invalid operation
802 API_EC_DATA_QUOTA_EXCEEDED Data store allowable quota was exceeded
803 API_EC_DATA_OBJECT_NOT_FOUND Specified object cannot be found
804 API_EC_DATA_OBJECT_ALREADY_EXISTS Specified object already exists
805 API_EC_DATA_DATABASE_ERROR A database error occurred. Please try again
806 API_EC_DATA_CREATE_TEMPLATE_ERROR Unable to add FBML template to template database. Please try again.
807 API_EC_DATA_TEMPLATE_EXISTS_ERROR No active template bundle with that ID or handle exists.
808 API_EC_DATA_TEMPLATE_HANDLE_TOO_LONG Template bundle handles must contain less than or equal to 32 characters.
809 API_EC_DATA_TEMPLATE_HANDLE_ALREADY_IN_USE Template bundle handle already identifies a previously registered template bundle, and handles can not be reused.
810 API_EC_DATA_TOO_MANY_TEMPLATE_BUNDLES Application has too many active template bundles, and some must be deactivated before new ones can be registered.
811 API_EC_DATA_MALFORMED_ACTION_LINK One of more of the supplied action links was improperly formatted.
812 API_EC_DATA_TEMPLATE_USES_RESERVED_TOKEN One …or more of your templates is using a token reserved by Facebook, such as {*mp3*} or {*video*}.

Mobile/SMS Errors

Error number PHP Constant name Error description Generated by methods
850 API_EC_SMS_INVALID_SESSION Invalid sms session.
851 API_EC_SMS_MSG_LEN Invalid sms message length.
852 API_EC_SMS_USER_QUOTA Over user daily sms quota.
853 API_EC_SMS_USER_ASLEEP Unable to send sms to user at this time.
854 API_EC_SMS_APP_QUOTA Over application daily sms quota/rate limit.
855 API_EC_SMS_NOT_REGISTERED User is not registered for Facebook Mobile Texts
856 API_EC_SMS_NOTIFICATIONS_OFF User has SMS notifications turned off
857 API_EC_SMS_CARRIER_DISABLE SMS application disallowed by mobile operator

Application Information Errors

Error number PHP Constant name Error description Generated by methods
900 API_EC_NO_SUCH_APP No such application exists.

Batch API Errors

Errornumber PHP Constant name Error description Generated by methods
950 API_BATCH_TOO_MANY_ITEMS Each batch API can not contain more than 20 items
951 API_EC_BATCH_ALREADY_STARTED begin_batch already called, please make sure to call end_batch first.
952 API_EC_BATCH_NOT_STARTED end_batch called before begin_batch.
953 API_EC_BATCH_METHOD_NOT_ALLOWED_IN_BATCH_MODE This method is not allowed in batch mode.

Events API Errors

Error number PHP Constant name Error description Generated by methods
1000 API_EC_EVENT_INVALID_TIME Invalid time for an event. events.edit
1001 API_EC_EVENT_NAME_LOCKED You are no longer able to change the name of this event. events.edit

Info Section Errors

Error number PHP Constant name Error description Generated by methods
1050 API_EC_INFO_NO_INFORMATION No information has been set for this user profile.setInfo
1051 API_EC_INFO_SET_FAILED Setting info failed. Check the formatting of your info fields. profile.setInfo

LiveMessage Errors

Errornumber PHP Constant name Error description Generated by methods
1100 API_EC_LIVEMESSAGE_SEND_FAILED An error occurred while sending the LiveMessage. liveMessage.send
1101 API_EC_LIVEMESSAGE_EVENT_NAME_TOO_LONG The event_name parameter must be no longer than 128 bytes. liveMessage.send
1102 API_EC_LIVEMESSAGE_MESSAGE_TOO_LONG The message parameter must be no longer than 1024 bytes. liveMessage.send

Chat Errors

Error number PHP Constant name Error description Generated by methods
1200 API_EC_CHAT_SEND_FAILED An error occurred while sending the message.

Facebook Page Errors

Error number PHP Constant name Error description Generated by methods
1201 API_EC_PAGES_CREATE You have created too many pages

Facebook Links Errors

Error number PHP Constant name Error description Generated by methods
1500 API_EC_SHARE_BAD_URL The url you supplied is invalid

Facebook Notes Errors

Error number PHP Constant name Error description Generated by methods
1600 API_EC_NOTE_CANNOT_MODIFY The user does not have permission to modify this note.

Comment Errors

Errornumber PHP Constant name Error description Generated by methods
1700 API_EC_COMMENTS_UNKNOWN An unknown error has occurred.
1701 API_EC_COMMENTS_POST_TOO_LONG The specified post was too long.
1702 API_EC_COMMENTS_DB_DOWN The comments database is down.
1703 API_EC_COMMENTS_INVALID_XID The specified xid is not valid. xids can only contain letters, numbers, and underscores
1704 API_EC_COMMENTS_INVALID_UID The specified user is not a user of this application
1705 API_EC_COMMENTS_INVALID_POST There was an error during posting.
1706 API_EC_COMMENTS_INVALID_REMOVE While attempting to remove the post.

 

 

Find my FAQ on Facebook Development useful? Download the PDF for all the FAQs HERE!