---
agentTools:
  projectIndex: https://docs.developer.yelp.com/llms.txt
---

# API Errors

When there is an error with any of the API calls, the response will have a non-200 HTTP status code and a JSON body describing the error. Besides from the common API errors listed, each API call will have its own errors described in their respective sections.

[block:parameters]
{
  "data": {
    "h-0": "Property",
    "h-1": "Type",
    "h-2": "Description",
    "0-0": "errors",
    "0-1": "[Error[]](https://docs.developer.yelp.com/v1.0/docs/api-errors#section-error)",
    "0-2": "see Error resource"
  },
  "cols": 3,
  "rows": 1
}
[/block]

Example:

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"errors\": [\n    {\n      \"error_code\": \"NOT_AUTHENTICATED\",\n      \"error_message\": \"please authenticate\",\n      \"more_info\": \"[http://www.yelp.com/developers/documentation/v2/overview](http://www.yelp.com/developers/documentation/v2/overview)\"\n    }\n  ]\n}",
      "language": "json"
    }
  ]
}
[/block]

\##Error

[block:parameters]
{
  "data": {
    "h-0": "Property",
    "h-1": "Type",
    "h-2": "Description",
    "0-0": "object",
    "1-0": "error_code",
    "2-0": "error_message",
    "3-0": "more_info",
    "0-1": "utf8_string(1..256)",
    "1-1": "utf8_string(1..64)",
    "2-1": "utf8_string(1..1024)",
    "3-1": "utf8_string(1..1024)",
    "0-2": "object type, value: `Error`",
    "1-2": "error code",
    "2-2": "error message",
    "3-2": "link to Yelp docs for the error message"
  },
  "cols": 3,
  "rows": 4
}
[/block]

\##Common API Errors

[block:parameters]
{
  "data": {
    "h-0": "Status",
    "h-1": "error_code",
    "h-2": "error_message (example)",
    "0-0": "400",
    "1-0": "400",
    "2-0": "401",
    "3-0": "500",
    "0-1": "FIELD_REQUIRED",
    "1-1": "VALIDATION_ERROR",
    "2-1": "UNAUTHORIZED",
    "3-1": "INTERNAL_SERVER_ERROR",
    "0-2": "<field> is required",
    "1-2": "<field> is invalid: <reason>",
    "2-2": "Please authenticate",
    "3-2": "Something is wrong with Yelp"
  },
  "cols": 3,
  "rows": 4
}
[/block]