Cisco AMP for Endpoints API

GET /v1/file_lists/simple_custom_detections

Description

Returns a list of simple custom detection file lists. You can filter this list by name.

Query Parameters

Name Type Example Values Description
limit Integer 3, 10
offset Integer 2
name[] String Quick SCD

Show Response Fields

Name Type Description
version String
metadata.links.self String
metadata.links.prev String
metadata.links.next String
metadata.results.total Integer
metadata.results.current_item_count Integer
metadata.results.index Integer
metadata.results.items_per_page Integer
data Array
data[].name String
data[].guid GUID
data[].type String
data[].links.file_list String
Write
Preview
Auto Generate

Examples

Fetch list of simple_custom_detections file_lists
Fetch list of simple_custom_detections file lists filtered by name

Fetch list of simple_custom_detections file_lists

Request

Requires Authorization 
GET /v1/file_lists/simple_custom_detections?limit=3&offset=2
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/v1/file_lists/simple_custom_detections?limit=3&offset=2'

Response

Shortened for readability 

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1963
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2807
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"14ae166a1a28d59d170070115185c316"
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.eu.amp.cisco.com/v1/file_lists/simple_custom_detections?limit=3&offset=2",
      "prev": "https://api.eu.amp.cisco.com/v1/file_lists/simple_custom_detections?limit=3&offset=0",
      "next": "https://api.eu.amp.cisco.com/v1/file_lists/simple_custom_detections?limit=3&offset=5"
    },
    "results": {
      "total": 7,
      "current_item_count": 3,
      "index": 2,
      "items_per_page": 3
    }
  },
  "data": [
    {
      "name": "Sample SCD List 1",
      "guid": "021f6434-0b67-4790-8601-b535d66ca0fb",
      "type": "simple_custom_detections",
      "links": {
        "file_list": "https://api.eu.amp.cisco.com/v1/file_lists/021f6434-0b67-4790-8601-b535d66ca0fb"
      }
    },
    {
      "name": "Sample SCD List 2",
      "guid": "db2b9dd6-94d2-4acc-a6cb-c4c66c9199a1",
      "type": "simple_custom_detections",
      "links": {
        "file_list": "https://api.eu.amp.cisco.com/v1/file_lists/db2b9dd6-94d2-4acc-a6cb-c4c66c9199a1"
      }
    }
  ]
}

Fetch list of simple_custom_detections file lists filtered by name

Request

Requires Authorization 
GET /v1/file_lists/simple_custom_detections?name%5B%5D=Quick%20SCD&limit=10
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/v1/file_lists/simple_custom_detections?name%5B%5D=Quick%20SCD&limit=10'

Response

Shortened for readability 

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1963
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2806
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"db294e034ca1b2cd529e075aa7a243ad"
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.eu.amp.cisco.com/v1/file_lists/simple_custom_detections?name%5B%5D=Quick%20SCD&limit=10"
    },
    "results": {
      "total": 1,
      "current_item_count": 1,
      "index": 0,
      "items_per_page": 10
    }
  },
  "data": [
    {
      "name": "Quick SCD",
      "guid": "03097bae-53f9-44b1-a0e5-d23b1f33a94a",
      "type": "simple_custom_detections",
      "links": {
        "file_list": "https://api.eu.amp.cisco.com/v1/file_lists/03097bae-53f9-44b1-a0e5-d23b1f33a94a"
      }
    }
  ]
}