| HTTP Status Code | Error code | Description | Troubleshooting |
|---|---|---|---|
| 200 | 0 | Success | |
| 202 | 3005 | IN_PROGRESS | Report is being created. Pull request should be resent. |
| 204 | 3006 | NO_CONTENT | No content was found for the requested apiId/s with the given parameters. |
| 400 | 2000 | BAD_REQUEST | The data entered by the user is invalid. Please verify that the URL used is correct. |
| 400 | 2002 | INVALID_ARGUMENTS | Missing or invalid parameter value. Please re-check the request sent and refer to specific error message in the response to get more information. |
| 401 | 1000 | UNAUTHORIZED | The action performed is unauthorized. Please contact Customer Support through The Support Portal in MyZone or contact your CSM. |
| 401 | 1001 | UNAUTHORIZED_DATA_SOURCE | Missing permission to pull demographics from the requested data set. |
| 403 | 1008 | PERMISSION_DENIED | No permission to access the entity. In case you can't query the requested entity from the dashboard, please contact Customer Support through The Support Portal in MyZone or contact your CSM. |
| 403 | 1016 | RESTRICTED_AREA | The report is not available for this POI as it contains at least one restricted area. Please contact Customer Support through The Support Portal in MyZone or contact your CSM. |
| 403 | NA | NA | Forbidden, wrong or missing API Key. |
| 404 | 3000 | ERROR_NOT_FOUND | The requested resource (POI) not found in the system. |
| 422 | 1025 | UNDELIVERABLE_ENTITY | The report is not available for this POI due to Placer's privacy policy |
| 429 | 2004 | RATE_LIMITED | Usage quota limit exceeded. Please refer to the following throttle rate limits : - Quota for reports preparation - 5000/hour(relevant for Visits / Loyalty / Trade Area / Visitor Journey / Retail Sales reports endpoints); - Quota for POI query/creation/deletion - 360/min or 10000/hour (relevant for all endpoints included in the manage POIs section); - Quota for ranking reports- 8000/min or 80000/hour (relevant for ranking reports endpoints) -General limitation - Execute up to 10 API calls/sec and up to 5 concurrent processes(Relevant for all endpoints) |
| 429 | 2005 | LIMIT_EXCEEDED | This error means that your request surpasses the permitted quota of queried API IDs. The quota will be renewed on the following Sunday. For any more details or to learn about expansion options you may contact your Placer customer success manager. |
| 500 | 5000 | GENERAL_ERROR | Internal Error. Please contact Customer Support through The Support Portal in MyZone or contact your CSM. |
| 504 | NA | NA | Endpoint request timed out. For more information on best practices visit here. |