Request Predefined EDL Content

GET 
/edl

A GET request to retrieve the predefined external dynamic lists by name and version.

Request

Query Parameters

name string
Possible values: [panw-known-ip-list, panw-highrisk-ip-list, panw-torexit-ip-list, panw-bulletproof-ip-list]
Provides the EDL by the name.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?name=panw-known-ip-list&version=latest'
ipaddr string
Provides the EDLs containing the IP address.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?ipaddr=192.0.2.0'
version string
Provides the EDL by the specific AV package version.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?name=panw-highrisk-ip-list&version=4024'
Use "latest" for latest release version:
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?ipaddr=192.0.2.0&version=latest'
listformat string
Possible values: [array]
Optional field to provide more convenient way to ingest the EDL.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?name=panw-known-ip-list&version=latest&listformat=array'
limit string
Optional parameter. The maximum number of results to return in each page.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?name=panw-known-ip-list&version=latest&limit=5'
offset string
Optional parameter. The starting position of the query in relation to the complete set of the unpaginated results.
---
curl -v -H 'X-API-KEY: API_KEY' \
  'https://api.threatvault.paloaltonetworks.com/service/v1/edl?name=panw-torexit-ip-list&version=latest&limit=5&offset=5'

Responses

200

Request succeeded

Response Headers

• X-Day-RateLimit-Limit integer
  Example: 2000

  The maximum number of requests that the user is permitted to make per day.

• X-Day-RateLimit-Remaining integer

  The number of requests remaining in the current rate limit window (one day).

• X-Day-RateLimit-Reset integer

  The epoch timestamp at which the current rate limit window (one day) resets.

• X-Minute-RateLimit-Limit integer
  Example: 200

  The maximum number of requests that the user is permitted to make per minute.

• X-Minute-RateLimit-Remaining integer

  The number of requests remaining in the current rate limit window (one minute).

• X-Minute-RateLimit-Reset integer

  The epoch timestamp at which the current rate limit window (one minute) resets.

application/json

Schema

Schema

data object[]
Array [
success boolean
The response status.
link object[]
The pagination information of the results.
Array [
next string
The URL of previous page with results.
previous string
The URL of next page with results.
]
count integer
The total number of entries found.
data object[]
The data of the response.
Array [
version string
The version of the release.
name string
The name of the predefined EDL.
ipaddr string
The IP address.
]
message string
Generic response message.
]

Example (from schema)

{
  "data": {}
}

4XX

Client related error response

application/json

Schema

Schema

message string

Generic response message.

success boolean

The response status.

Example (from schema)

{
  "message": "Error message.",
  "success": false
}

5XX

Server related error response

application/json

Schema

Schema

message string

Generic response message.

success boolean

The response status.

Example (from schema)

{
  "message": "Error message.",
  "success": false
}

Loading...