GET /v0/computers
Description
Returns a list of computers with agents deployed on them. You can use parameters to narrow the search by IP address or hostname.
Query Parameters
Name | Type | Example Values | Description |
---|---|---|---|
internal_ip |
String | 202.146.2.246 | |
limit |
Integer | 10 | |
offset |
Integer | 20 | |
external_ip |
String | 226.13.104.250 | |
group_guid[] |
GUID | 6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03 | |
hostname[] |
String | Demo_AMP |
Name | Type | Description |
---|---|---|
version | String | |
metadata.links.self | String | |
metadata.results.total | Integer | |
metadata.results.current_item_count | Integer | |
metadata.results.index | Integer | |
metadata.results.items_per_page | Integer | |
data | Array | |
data[].connector_guid | GUID | |
data[].hostname | String | |
data[].active | Boolean | |
data[].links.computer | String | |
data[].links.trajectory | String | |
data[].links.group | String | |
data[].connector_version | String | |
data[].operating_system | String | |
data[].internal_ips | Array | |
data[].internal_ips[] | String | |
data[].external_ip | String | |
data[].group_guid | GUID | |
data[].install_date | String (Time ISO8601) | |
data[].network_addresses | Array | |
data[].network_addresses[].mac | String | |
data[].network_addresses[].ip | String | |
data[].policy.guid | GUID | |
data[].policy.name | String | |
data[].last_seen | String (Time ISO8601) | |
data[].faults | Array |
Examples
- Fetch list of computers
- Fetch list of computers filtered by hostname
- Fetch list of computers filtered by internal_ip
- Fetch list of computers filtered by external_ip
- Fetch list of computers filtered by group_guid
Fetch list of computers
Request
Requires AuthorizationGET /v0/computers
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
cURL Edit, then copy and paste on your terminal
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.eu.amp.cisco.com/v0/computers'
Response
cURL Edit, then copy and paste on your terminal
curl -X GET \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -u YOUR_API_CLIENT_ID \ 'https://api.eu.amp.cisco.com/v0/computers'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 200 OK x-ratelimit-limit: 3000 x-ratelimit-reset: 901 strict-transport-security: max-age=31536000; includeSubDomains, max-age=31536000 referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2862 x-permitted-cross-domain-policies: none x-download-options: noopen etag: W/"3c7e07f36ae951b11d894b982636a27f" x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v0.2.2",
"metadata": {
"links": {
"self": "https://api.eu.amp.cisco.com/v0/computers"
},
"results": {
"total": 52,
"current_item_count": 52,
"index": 0,
"items_per_page": 500
}
},
"data": [
{
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:01Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
},
{
"connector_guid": "8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"hostname": "Demo_AMP_Exploit_Prevention",
"windows_processor_id": "30f6257891edb4a",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"99.193.103.205"
],
"external_ip": "61.151.3.61",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:00Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "c1:f9:f5:d3:ba:54",
"ip": "99.193.103.205"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:00Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
]
}
Fetch list of computers filtered by hostname
Request
Requires AuthorizationGET /v0/computers?hostname%5B%5D=Demo_AMP&limit=10&offset=0
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
cURL Edit, then copy and paste on your terminal
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.eu.amp.cisco.com/v0/computers?hostname%5B%5D=Demo_AMP&limit=10&offset=0'
Response
cURL Edit, then copy and paste on your terminal
curl -X GET \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -u YOUR_API_CLIENT_ID \ 'https://api.eu.amp.cisco.com/v0/computers?hostname%5B%5D=Demo_AMP&limit=10&offset=0'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 200 OK x-ratelimit-limit: 3000 x-ratelimit-reset: 900 strict-transport-security: max-age=31536000; includeSubDomains, max-age=31536000 referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2861 x-permitted-cross-domain-policies: none x-download-options: noopen etag: W/"fa982b1a4c8249bdda1b5e797e9a8ef9" x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v0.2.2",
"metadata": {
"links": {
"self": "https://api.eu.amp.cisco.com/v0/computers?hostname%5B%5D=Demo_AMP&limit=10&offset=0"
},
"results": {
"total": 7,
"current_item_count": 7,
"index": 0,
"items_per_page": 10
}
},
"data": [
{
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:01Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
},
{
"connector_guid": "8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"hostname": "Demo_AMP_Exploit_Prevention",
"windows_processor_id": "30f6257891edb4a",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"99.193.103.205"
],
"external_ip": "61.151.3.61",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:00Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "c1:f9:f5:d3:ba:54",
"ip": "99.193.103.205"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:00Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
]
}
Fetch list of computers filtered by internal_ip
Request
Requires AuthorizationGET /v0/computers?internal_ip=74.177.148.86&limit=10&offset=0
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
cURL Edit, then copy and paste on your terminal
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.eu.amp.cisco.com/v0/computers?internal_ip=74.177.148.86&limit=10&offset=0'
Response
cURL Edit, then copy and paste on your terminal
curl -X GET \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -u YOUR_API_CLIENT_ID \ 'https://api.eu.amp.cisco.com/v0/computers?internal_ip=74.177.148.86&limit=10&offset=0'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 200 OK x-ratelimit-limit: 3000 x-ratelimit-reset: 900 strict-transport-security: max-age=31536000; includeSubDomains, max-age=31536000 referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2860 x-permitted-cross-domain-policies: none x-download-options: noopen etag: W/"fc9d883d86c455942af13200d3513f78" x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v0.2.2",
"metadata": {
"links": {
"self": "https://api.eu.amp.cisco.com/v0/computers?internal_ip=74.177.148.86&limit=10&offset=0"
},
"results": {
"total": 1,
"current_item_count": 1,
"index": 0,
"items_per_page": 10
}
},
"data": [
{
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:01Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
]
}
Fetch list of computers filtered by external_ip
Request
Requires AuthorizationGET /v0/computers?external_ip=78.127.198.189&limit=10&offset=0
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
cURL Edit, then copy and paste on your terminal
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.eu.amp.cisco.com/v0/computers?external_ip=78.127.198.189&limit=10&offset=0'
Response
cURL Edit, then copy and paste on your terminal
curl -X GET \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -u YOUR_API_CLIENT_ID \ 'https://api.eu.amp.cisco.com/v0/computers?external_ip=78.127.198.189&limit=10&offset=0'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 200 OK x-ratelimit-limit: 3000 x-ratelimit-reset: 900 strict-transport-security: max-age=31536000; includeSubDomains, max-age=31536000 referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2859 x-permitted-cross-domain-policies: none x-download-options: noopen etag: W/"296f601aa9d6baf56d53b83f99e0c528" x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v0.2.2",
"metadata": {
"links": {
"self": "https://api.eu.amp.cisco.com/v0/computers?external_ip=78.127.198.189&limit=10&offset=0"
},
"results": {
"total": 1,
"current_item_count": 1,
"index": 0,
"items_per_page": 10
}
},
"data": [
{
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:01Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
]
}
Fetch list of computers filtered by group_guid
Request
Requires AuthorizationGET /v0/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
cURL Edit, then copy and paste on your terminal
curl -X GET \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-u YOUR_API_CLIENT_ID \
'https://api.eu.amp.cisco.com/v0/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0'
Response
cURL Edit, then copy and paste on your terminal
curl -X GET \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'accept-encoding: identity' \ --compressed -H 'Accept-Encoding: gzip, deflate' \ -u YOUR_API_CLIENT_ID \ 'https://api.eu.amp.cisco.com/v0/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0'
Shortened for readability
content-type: application/json transfer-encoding: chunked status: 200 OK x-ratelimit-limit: 3000 x-ratelimit-reset: 899 strict-transport-security: max-age=31536000; includeSubDomains, max-age=31536000 referrer-policy: strict-origin-when-cross-origin x-ratelimit-remaining: 2858 x-permitted-cross-domain-policies: none x-download-options: noopen etag: W/"0fb635c5f6e616d65313e89a876c1f0e" x-frame-options: SAMEORIGIN x-ratelimit-resetdate: 2022-03-18T11:55:11Z
{
"version": "v0.2.2",
"metadata": {
"links": {
"self": "https://api.eu.amp.cisco.com/v0/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0",
"next": "https://api.eu.amp.cisco.com/v0/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=10"
},
"results": {
"total": 13,
"current_item_count": 10,
"index": 0,
"items_per_page": 10
}
},
"data": [
{
"connector_guid": "bad2c522-3052-4d75-93a0-832d6283c299",
"hostname": "Demo_AMP",
"windows_processor_id": "195b0d8736e2af4",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/bad2c522-3052-4d75-93a0-832d6283c299/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"74.177.148.86"
],
"external_ip": "78.127.198.189",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:01Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "31:5e:f7:d7:d3:31",
"ip": "74.177.148.86"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:01Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
},
{
"connector_guid": "8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"hostname": "Demo_AMP_Exploit_Prevention",
"windows_processor_id": "30f6257891edb4a",
"active": true,
"links": {
"computer": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c",
"trajectory": "https://api.eu.amp.cisco.com/v0/computers/8ebeb060-465f-41a7-b7d0-b4490d8cc08c/trajectory",
"group": "https://api.eu.amp.cisco.com/v0/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
},
"connector_version": "99.0.99.20946",
"operating_system": "Windows 10",
"os_version": "10.0.19044.1466",
"internal_ips": [
"99.193.103.205"
],
"external_ip": "61.151.3.61",
"group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"install_date": "2022-02-16T11:40:00Z",
"is_compromised": false,
"demo": true,
"network_addresses": [
{
"mac": "c1:f9:f5:d3:ba:54",
"ip": "99.193.103.205"
}
],
"policy": {
"guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
"name": "Protect Policy"
},
"groups": [
{
"guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
"name": "Protect"
}
],
"last_seen": "2022-03-18T11:40:00Z",
"faults": [
],
"isolation": {
"available": false,
"status": "not_isolated"
},
"orbital": {
"status": "not_enabled"
}
}
]
}