# Errors URL: https://docs.emergingtravel.com/docs/fundamentals/errors/ Tags: fundamentals --- ## Error fields The `debug` response field has information on your error. ```json { "data": null, "debug": { "api_endpoint": { "endpoint": "api/b2b/v3/hotel/info/", "is_active": true, "is_limited": true, "remaining": 9, "requests_number": 10, "reset": "2018-08-16T12:12:37", "seconds_number": 1 }, "api_key_id": 1304, "method": "GET", "real_ip": "62.76.100.3", "request_id": "68c1141361db8c82835ea268486d7c6f", "utcnow": "2018-08-16T12:12:36.328390" }, "error": "decoding_json", "status": "error" } ``` ## 400 ### Invalid parameters The error occurs if all required data isn’t passed. Check the `validation_error` field and pass the required data. ```json { "data": null, "debug": { "api_endpoint": { "endpoint": "api/b2b/v3/hotel/order/info/", "is_active": true, "is_limited": true, "remaining": 9, "requests_number": 10, "reset": "2018-08-23T09:59:38", "seconds_number": 1 }, "api_key_id": 1304, "method": "POST", "real_ip": "52.29.104.100", "request_id": "7f4937bdabe8bb13d4980dcd77a16117", "utcnow": "2018-08-23T09:59:37.495757", "validation_error": "value \"page_number\" is required but None" }, "error": "invalid_params", "status": "error" } ``` ### Not allowed host The error occurs if it is forbidden to request your host or IP. > [!NOTE] > To discuss a change to the permission, contact the API support team. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "7b76e52a742f714e6686761fab48cfa3", "utcnow": "2018-08-23T11:31:44.235203" }, "error": "not_allowed_host", "status": "error" } ``` ### Unexpected method The error occurs if the request was made using an unsupported HTTP method. Use the POST and GET methods instead. ```json { "data": null, "debug": { "api_key_id": 1304, "real_ip": "52.29.104.100", "request_id": "19925f65c2763212bbe37294178b6fa6", "utcnow": "2018-08-23T09:56:37.677774" }, "error": "unexpected_method", "status": "error" } ``` ### Invalid Json body type The request body must be a JSON object ({}), but received a different JSON type (e.g., array, string, number). ```json { "data": null, "debug": { "api_endpoint": { "endpoint": "api/b2b/v3/hotel/order/booking/form/", "is_active": true, "is_limited": true, "remaining": 289, "requests_number": 290, "reset": "2025-08-05T15:20:00", "seconds_number": 600 }, "api_key_id": 1304, "method": "POST", "real_ip": "10.8.43.143", "request_id": "4f75423b026798027165be29ff56141b", "utcnow": "2025-08-05T15:12:00.046036" }, "error": "body_must_be_json_object", "status": "error" } ``` ## 402 ### Overdue debt The error occurs if you have an overdue debt. > [!NOTE] > Contact your account manager. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "36f4a2ae479cc0eba8e3ddf7d09bba14", "utcnow": "2018-08-23T10:11:08.045023" }, "error": "overdue_debt", "status": "error" } ``` ## 403 ### Authorization header The error occurs if the request: * Has no authorization header. * Has invalid data in the authorization header. The `error` response field can have the following values: * `no_auth_header`. * `invalid_auth_header`. > [!NOTE] > Check the [Authorization](/docs/fundamentals/authorization/) section. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "563c919d77000963a4ef9ade0988b21b", "utcnow": "2018-08-23T10:03:28.794712" }, "error": "no_auth_header", "status": "error" } ``` ### Endpoint is not found The error occurs if you don’t have permission to use the call. > [!NOTE] > To discuss a change to the permission, contact your account manager. ```json { "data": null, "debug": { "api_key_id": 1775, "method": "POST", "real_ip": "10.11.0.23", "request_id": "45141c733a1f4d534a0518c513d3641b", "status": 403, "utcnow": "2018-08-14T12:51:58.715639" }, "error": "endpoint_not_found", "status": "error" } ``` ## Authentication and Authorization Errors > [!NOTE] > In case of recurring unauthorized requests over a considerable period, the ETG may ban the IP address of sent requests. ### Incorrect API credentials This error occurs if you have used incorrect API credentials. > [!NOTE] > Make sure your API key and other authentication details are valid. For additional help, contact your account manager. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "e6ff36a9e635825743e7ded8c05739a0", "utcnow": "2018-08-23T09:34:43.673713" }, "error": "incorrect_credentials", "status": "error" } ``` ### API access disabled API access is disabled for your account. > [!NOTE] > For inquiries about enabling API access, please contact your account manager. ```json { "data": null, "debug": { "request": { "checkin": "2025-07-18", "checkout": "2025-07-19", "residency": "KW", "language": "en", "guests": [ { "adults": 2, "children": [] } ], "id": "test_hotel_do_not_book", "currency": "KWD" }, "key_id": 0, "validation_error": null }, "status": "error", "error": "api_access_disabled" } ``` ### Not allowed The error occurs if your API key doesn’t have permission to use this API call. > [!NOTE] > To discuss a change to the permission, contact your account manager. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "7b76e52a742f714e6686761fab48cfa3", "utcnow": "2018-08-23T11:31:44.235203" }, "error": "not_allowed", "status": "error" } ``` ## Endpoint is not active The error occurs if the endpoint is deactivated. > [!NOTE] > To discuss a change to the activation, contact your account manager. ```json { "data": null, "debug": { "api_endpoint": { "endpoint": "api/b2b/v3/hotel/info/", "is_active": false, "is_limited": true, "requests_number": 1, "seconds_number": 20 }, "api_key_id": 496, "method": "GET", "real_ip": "10.11.0.23", "request_id": "61c015d15d325f0bb945db5d027fc35c", "utcnow": "2018-08-16T12:38:38.481018" }, "error": "endpoint_not_active", "status": "error" } ``` ## 429 ### Limit is exceeded The error occurs if you have exceeded the number of requests for an endpoint. > [!NOTE] > To discuss a change in the limit, contact your account manager. ```json { "data": null, "debug": { "api_endpoint": { "endpoint": "api/b2b/v3/hotel/info/", "is_active": true, "is_limited": true, "remaining": -1, "requests_number": 1, "reset": "2018-08-16T12:32:40", "seconds_number": 20 }, "api_key_id": 496, "method": "GET", "real_ip": "10.11.0.23", "request_id": "8dd3efd24bdd6a9272770936e5108f8c", "utcnow": "2018-08-16T12:32:26.161565" }, "error": "endpoint_exceeded_limit", "status": "error" } ``` ### Endpoint is locked This error occurs if requests for an endpoint meet both conditions: * Several requests use the same `partner_order_id` field value. * One request is sent twice within a short amount of time. ```json { "data": null, "debug": { "real_ip": "52.29.104.100", "request_id": "2c2264a2f3f64b9032624e99ddd49976", "utcnow": "2018-08-23T11:43:27.101799" }, "error": "lock", "status": "error" } ``` ## 5xx errors Errors with the `5xx` HTTP status code may occur. Typically due to a timeout in the ETG services. In this case, do both: * Retry the request. * Limit the number of repeated identical requests. For these calls, refer to the descriptions of the call errors: * Create booking process ([B2B](/docs/b2b-api/booking/create-booking-process/), [Affiliate](/docs/affiliate-api/booking/create-booking-process/)). * Start booking process ([B2B](/docs/b2b-api/booking/start-booking-process/), [Affiliate](/docs/affiliate-api/booking/start-booking-process/)). * Check booking process ([B2B](/docs/b2b-api/booking/check-booking-process/), [Affiliate](/docs/affiliate-api/booking/check-booking-process/)). ## Example of unknown error The error occurs if something else has gone wrong. ```json { "data": null, "debug": null, "error": "unknown", "status": "error" } ```