Cisco AMP for Endpoints API

GET /v1/computers

Description

Query Parameters

Name	Type	Example Values
`hostname[]`	Date	Demo_AMP_MAP_FriedEx
`limit`	Integer	10
`offset`	Integer	20
`internal_ip`	String	212.143.221.79
`external_ip`	String	102.141.238.162
`group_guid[]`	GUID	6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03

Show Response Fields

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
data[].isolation.available	Boolean
data[].isolation.status	String

Note

The hostname search is conducted with an ending wildcard so a list of hosts will be returned if multiple matches occur.

Write

Preview

Describe this action in markdown

### Query Parameters

|Name|Type|Example Values|Description|
|----|----|----|----|
|`hostname[]`|Date|Demo_AMP_MAP_FriedEx||
|`limit`|Integer|10||
|`offset`|Integer|20||
|`internal_ip`|String|212.143.221.79||
|`external_ip`|String|102.141.238.162||
|`group_guid[]`|GUID|6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03||
[Show Response Fields](response-fields)

|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||
|data[].isolation.available|Boolean||
|data[].isolation.status|String||

### Note

The hostname search is conducted with an ending wildcard so a list of hosts will be returned if multiple matches occur.

Auto Generate

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 Authorization

GET /v1/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.amp.cisco.com/v1/computers'

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1988
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2853
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"5c252d0914b6ea68c311d97e8a147406"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/computers"
    },
    "results": {
      "total": 49,
      "current_item_count": 49,
      "index": 0,
      "items_per_page": 500
    }
  },
  "data": [
    {
      "connector_guid": "55d4faec-9481-4686-a667-f71ec35e7a6d",
      "hostname": "Demo_AMP",
      "windows_processor_id": "1b932e70da84f65",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d",
        "trajectory": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "29.185.115.160"
      ],
      "external_ip": "182.209.164.92",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "c4:dd:c2:53:e2:cc",
          "ip": "29.185.115.160"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    },
    {
      "connector_guid": "b0f547f1-6808-42f2-9045-968d5ce3a173",
      "hostname": "Demo_AMP_Exploit_Prevention",
      "windows_processor_id": "579e6db0a81342f",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/b0f547f1-6808-42f2-9045-968d5ce3a173",
        "trajectory": "https://api.amp.cisco.com/v1/computers/b0f547f1-6808-42f2-9045-968d5ce3a173/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/b077d6bc-bbdf-42f7-8838-a06053fbd98a"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "176.148.110.195"
      ],
      "external_ip": "67.241.131.94",
      "group_guid": "b077d6bc-bbdf-42f7-8838-a06053fbd98a",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "83:1b:2f:01:6d:01",
          "ip": "176.148.110.195"
        }
      ],
      "policy": {
        "guid": "3dc1435d-bdc8-4a9d-9da5-e7371562378d",
        "name": "00-cat-forensic-mar25"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "av_update_definitions": {
        "status": "Definitions Outdated",
        "detection_engine": "TETRA 64 bit"
      },
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    }
  ]
}

Fetch list of computers filtered by hostname

Request

Requires Authorization

GET /v1/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.amp.cisco.com/v1/computers?hostname%5B%5D=Demo_AMP&limit=10&offset=0'

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1987
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2852
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"66952851c004f0af93d554e05f992426"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/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": "55d4faec-9481-4686-a667-f71ec35e7a6d",
      "hostname": "Demo_AMP",
      "windows_processor_id": "1b932e70da84f65",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d",
        "trajectory": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "29.185.115.160"
      ],
      "external_ip": "182.209.164.92",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "c4:dd:c2:53:e2:cc",
          "ip": "29.185.115.160"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    },
    {
      "connector_guid": "b0f547f1-6808-42f2-9045-968d5ce3a173",
      "hostname": "Demo_AMP_Exploit_Prevention",
      "windows_processor_id": "579e6db0a81342f",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/b0f547f1-6808-42f2-9045-968d5ce3a173",
        "trajectory": "https://api.amp.cisco.com/v1/computers/b0f547f1-6808-42f2-9045-968d5ce3a173/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/b077d6bc-bbdf-42f7-8838-a06053fbd98a"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "176.148.110.195"
      ],
      "external_ip": "67.241.131.94",
      "group_guid": "b077d6bc-bbdf-42f7-8838-a06053fbd98a",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "83:1b:2f:01:6d:01",
          "ip": "176.148.110.195"
        }
      ],
      "policy": {
        "guid": "3dc1435d-bdc8-4a9d-9da5-e7371562378d",
        "name": "00-cat-forensic-mar25"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "av_update_definitions": {
        "status": "Definitions Outdated",
        "detection_engine": "TETRA 64 bit"
      },
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    }
  ]
}

Fetch list of computers filtered by internal_ip

Request

Requires Authorization

GET /v1/computers?internal_ip=29.185.115.160&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.amp.cisco.com/v1/computers?internal_ip=29.185.115.160&limit=10&offset=0'

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1987
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2851
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"446fd663aa3a02c8a641104254752434"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/computers?internal_ip=29.185.115.160&limit=10&offset=0"
    },
    "results": {
      "total": 1,
      "current_item_count": 1,
      "index": 0,
      "items_per_page": 10
    }
  },
  "data": [
    {
      "connector_guid": "55d4faec-9481-4686-a667-f71ec35e7a6d",
      "hostname": "Demo_AMP",
      "windows_processor_id": "1b932e70da84f65",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d",
        "trajectory": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "29.185.115.160"
      ],
      "external_ip": "182.209.164.92",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "c4:dd:c2:53:e2:cc",
          "ip": "29.185.115.160"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    }
  ]
}

Fetch list of computers filtered by external_ip

Request

Requires Authorization

GET /v1/computers?external_ip=182.209.164.92&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.amp.cisco.com/v1/computers?external_ip=182.209.164.92&limit=10&offset=0'

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1987
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2850
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"5b1c7241717a17fab8bd0133ebf8a1e8"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/computers?external_ip=182.209.164.92&limit=10&offset=0"
    },
    "results": {
      "total": 1,
      "current_item_count": 1,
      "index": 0,
      "items_per_page": 10
    }
  },
  "data": [
    {
      "connector_guid": "55d4faec-9481-4686-a667-f71ec35e7a6d",
      "hostname": "Demo_AMP",
      "windows_processor_id": "1b932e70da84f65",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d",
        "trajectory": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "29.185.115.160"
      ],
      "external_ip": "182.209.164.92",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "c4:dd:c2:53:e2:cc",
          "ip": "29.185.115.160"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    }
  ]
}

Fetch list of computers filtered by group_guid

Request

Requires Authorization

GET /v1/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.amp.cisco.com/v1/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0'

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1986
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2849
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"d55c88c89b3793b5792d2fb4a52d3129"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000

{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=0",
      "next": "https://api.amp.cisco.com/v1/computers?group_guid%5B%5D=6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03&limit=10&offset=10"
    },
    "results": {
      "total": 22,
      "current_item_count": 10,
      "index": 0,
      "items_per_page": 10
    }
  },
  "data": [
    {
      "connector_guid": "55d4faec-9481-4686-a667-f71ec35e7a6d",
      "hostname": "Demo_AMP",
      "windows_processor_id": "1b932e70da84f65",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d",
        "trajectory": "https://api.amp.cisco.com/v1/computers/55d4faec-9481-4686-a667-f71ec35e7a6d/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "29.185.115.160"
      ],
      "external_ip": "182.209.164.92",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:31Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "c4:dd:c2:53:e2:cc",
          "ip": "29.185.115.160"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:31Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    },
    {
      "connector_guid": "6cf0fcfe-10c0-412e-b274-4b6ea92bd6ef",
      "hostname": "Demo_AMP_Exploit_Prevention_Audit",
      "windows_processor_id": "63847520db9efa1",
      "active": true,
      "links": {
        "computer": "https://api.amp.cisco.com/v1/computers/6cf0fcfe-10c0-412e-b274-4b6ea92bd6ef",
        "trajectory": "https://api.amp.cisco.com/v1/computers/6cf0fcfe-10c0-412e-b274-4b6ea92bd6ef/trajectory",
        "group": "https://api.amp.cisco.com/v1/groups/6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03"
      },
      "connector_version": "99.0.99.30065",
      "operating_system": "Windows 10 Enterprise",
      "internal_ips": [
        "126.230.114.96"
      ],
      "external_ip": "48.155.171.234",
      "group_guid": "6c3c2005-4c74-4ba7-8dbb-c4d5b6bafe03",
      "install_date": "2021-04-05T23:22:32Z",
      "is_compromised": false,
      "network_addresses": [
        {
          "mac": "ae:9f:95:30:90:35",
          "ip": "126.230.114.96"
        }
      ],
      "policy": {
        "guid": "520c7c68-a637-43b1-b851-7830b0b336b6",
        "name": "Protect Policy"
      },
      "last_seen": "2021-05-05T23:22:32Z",
      "faults": [

      ],
      "isolation": {
        "available": false,
        "status": "not_isolated"
      },
      "orbital": {
        "status": "not_enabled"
      }
    }
  ]
}