Handling Errors

Requests made to our APIs can result in several different error responses. The following document describes the recovery tactics and provides a list of error values with a map to the most common recovery tactic to use.

Error Responses

The following represents a common error response resulting from a failed API request:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

• message : A human-readable description of the error.
• code : An error code. Common values are listed below, along with common recovery tactics.
• error_subcode : Additional information about the error. Common values are listed below.
• error_user_msg : The message to display to the user. The language of the message is based on the locale of the API request.
• error_user_title : The title of the dialog, if shown. The language of the message is based on the locale of the API request.
• fbtrace_id : Internal support identifier. When reporting a bug related to a Graph API call, include the fbtrace_id to help us find log data for debugging. However, this ID will expire shortly. To help the support team reproduce your issue, please attach a saved graph explorer session .

Error Codes

Authentication Error Subcodes

Rate Limiting Error Codes

Visit the Graph API Rate Limits guide for more information about Rate Limiting Error Codes.