{"__v":0,"_id":"5818de3c87c20b0f0086a239","category":{"__v":19,"_id":"5615790d0f5ed00d00483dd5","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"},"parentDoc":null,"project":"5615790c0f5ed00d00483dd1","user":"560b40145148ba0d009bd0b5","version":{"__v":6,"_id":"5615790d0f5ed00d00483dd4","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-01T18:26:04.370Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Welcome to the Cisco Umbrella Investigate API! \n\nAccess to this API requires an access token, configurable from your account settings. This service allows the querying of the Umbrella DNS database and goes beyond traditional DNS results to show security events and correlations in our datasets. Cisco Umbrella Investigate is the interface to the security data collated by our research team. The RESTful API opens up the power of Investigate's classification results, correlation, and history and is based on the Umbrella global network, the world’s largest security network. These results are generated dynamically and in real time, acting as a counter to today’s advanced persistent threats targeting enterprises that rely on traditionally static defense devices.\n\nThe Umbrella Investigate API is organized around the principles of REST. Our API lets you gather results from Investigate with anything that can send an HTTP request, including cURL and modern internet browsers. There are many things you can do with our REST API, for example:\n\n* Check the security status of a domain, IP address or subset of domains that appear in the logs from your firewall, UTM or other Internet egress points\n* Determine whether other related, co-occurring domains were accessed at the same time as the domain or IP you're looking up\n* Find a historical record for this domain or IP address in our DNS database to see what has changed\n* Query large numbers of domains quickly to find out whether they're scored as malicious and require further investigation\n\n---\n**Introduction to Cisco Umbrella Investigate** > [About the API and Authentication](https://docs.umbrella.com/developer/investigate-api/about-the-api-authentication/)","excerpt":"","slug":"introduction-to-cisco-investigate","type":"basic","title":"Introduction to Cisco Umbrella Investigate"}

Introduction to Cisco Umbrella Investigate


Welcome to the Cisco Umbrella Investigate API! Access to this API requires an access token, configurable from your account settings. This service allows the querying of the Umbrella DNS database and goes beyond traditional DNS results to show security events and correlations in our datasets. Cisco Umbrella Investigate is the interface to the security data collated by our research team. The RESTful API opens up the power of Investigate's classification results, correlation, and history and is based on the Umbrella global network, the world’s largest security network. These results are generated dynamically and in real time, acting as a counter to today’s advanced persistent threats targeting enterprises that rely on traditionally static defense devices. The Umbrella Investigate API is organized around the principles of REST. Our API lets you gather results from Investigate with anything that can send an HTTP request, including cURL and modern internet browsers. There are many things you can do with our REST API, for example: * Check the security status of a domain, IP address or subset of domains that appear in the logs from your firewall, UTM or other Internet egress points * Determine whether other related, co-occurring domains were accessed at the same time as the domain or IP you're looking up * Find a historical record for this domain or IP address in our DNS database to see what has changed * Query large numbers of domains quickly to find out whether they're scored as malicious and require further investigation --- **Introduction to Cisco Umbrella Investigate** > [About the API and Authentication](https://docs.umbrella.com/developer/investigate-api/about-the-api-authentication/)