{"_id":"581a0d924ca9f50f00d64fc8","project":"5615790c0f5ed00d00483dd1","parentDoc":null,"__v":0,"category":{"_id":"5615790d0f5ed00d00483dd5","__v":19,"pages":["5615790e0f5ed00d00483dd7","561d48e46386060d00e06003","561d48fe31d9630d001eb5bd","561d49b657165b0d00aa5d8b","561d4a879463520d00cd11e2","561d67f48ca8b90d00210234","561d6a0bf0cff80d00ca22c3","561d6c5b071cd60d000d3221","562f9c2543c5570d001fe6bd","56311c99eae7ef0d00270e3d","56311d6702aff217007dba23","56311f96f1c0580d00fac719","563120b7242cda1900198b79","5631229bf1c0580d00fac721","563131559ead230d00a188f6","563134a324014b0d00bd9a4f","5631392082d96a0d00b0fb1d","56313c584b36120d00fdebfb","5642658ef424a10d00118360"],"project":"5615790c0f5ed00d00483dd1","version":"5615790d0f5ed00d00483dd4","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-07T19:57:01.871Z","from_sync":false,"order":0,"slug":"opendns-investigate-rest-api","title":"Umbrella Investigate REST API"},"user":"560b40145148ba0d009bd0b5","version":{"_id":"5615790d0f5ed00d00483dd4","__v":6,"project":"5615790c0f5ed00d00483dd1","createdAt":"2015-10-07T19:57:01.307Z","releaseDate":"2015-10-07T19:57:01.307Z","categories":["5615790d0f5ed00d00483dd5","56157b2af432910d0000f9fe","56157cfb0f5ed00d00483ddb","562684d95db46b1700fd4f48","573b7ea9ef164e2900a2b8ff","582e285d8373c20f00810608"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-02T16:00:18.582Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"The Investigate API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information, and codes in the 5xx range indicate an error with Umbrella's servers.\n\n__HTTP Responses:__\n\n* **200 OK**—Everything worked as expected.\n* **204 OK**—Everything worked as expected but no content was returned. The domain classifier service returns this for domains Umbrella has no information on.\n* **400 Bad Request**—Likely missing a required parameter or malformed JSON. Please check the syntax on your query.\n* **403 Unauthorized**—Request had Authorization header but token was missing or invalid. Please ensure your API token is valid.\n* **404 Not Found**—The requested item doesn't exist, check the syntax of your query or ensure the IP and/or domain are valid.\n* **500**, **502**, **503**, 504 **Server** errors—something went wrong on our end.\n\n---\n[Requests](https://docs.umbrella.com/developer/investigate-api/requests-1/) < **Error Handling** > [Domain Status and Categorization](https://docs.umbrella.com/developer/investigate-api/domain-status-and-categorization-1/)","excerpt":"","slug":"error-handling-1","type":"basic","title":"Error Handling"}
The Investigate API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information, and codes in the 5xx range indicate an error with Umbrella's servers. __HTTP Responses:__ * **200 OK**—Everything worked as expected. * **204 OK**—Everything worked as expected but no content was returned. The domain classifier service returns this for domains Umbrella has no information on. * **400 Bad Request**—Likely missing a required parameter or malformed JSON. Please check the syntax on your query. * **403 Unauthorized**—Request had Authorization header but token was missing or invalid. Please ensure your API token is valid. * **404 Not Found**—The requested item doesn't exist, check the syntax of your query or ensure the IP and/or domain are valid. * **500**, **502**, **503**, 504 **Server** errors—something went wrong on our end. --- [Requests](https://docs.umbrella.com/developer/investigate-api/requests-1/) < **Error Handling** > [Domain Status and Categorization](https://docs.umbrella.com/developer/investigate-api/domain-status-and-categorization-1/)