Skip to main content

Request Threat Signature Release History

GET 
/threats/history

A GET request to retrieve the threats signature release history by id and package type.

  • Notes:
    • The retention policy of Antivirus release history data is for 1 year (only the last 1 year of release history data will be available).
    • The retention policy of WildFire release history data is for 30 days (only the last 30 days of release history data will be available).
    • Any Antivirus / WildFire release history information before Version 4140 is best-effort since the information is not available.
    • The Antivirus / WildFire version field in the responses before Version 4140 is in the format of XXXX (ex. "version": "4140") and after that the format is XXXX-YYYY (ex. "version": "4141-4637").
    • The Antivirus / WildFire release time before Version 4140 is the package start building time as the actual release time is not available.

Request​

Query Parameters

    type stringrequired

    Possible values: [antivirus, wildfire]

    Provides the threat signature metadata based on the threat type.

    ⚠️ Use without quotes

    • Options:
      • antivirus (Provides Antivirus signature release information)
      • wildfire (Provides WildFire signature release information)
    id stringrequired

    Provides the threat signature release history by matching the signature id in the releases.

    curl -v -H 'X-API-KEY: API_KEY' \
      'https://api.threatvault.paloaltonetworks.com/service/v1/threats/history?id=280392504&type=antivirus'
    limit string

    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/threats/history?id=280392504&type=antivirus&limit=3'
    offset string

    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/threats/history?id=280392504&type=antivirus&limit=3&offset=3'
    order string

    Possible values: [asc, desc]

    The order in which the results to be returned.

    ⚠️ Use without quotes

    curl -v -H 'X-API-KEY: API_KEY' \
      'https://api.threatvault.paloaltonetworks.com/service/v1/threats/history?id=280392504&type=antivirus&order=desc'

Responses​

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.

Schema
    count integer

    The total number of entries found.

    data object[]

    The data of the response.

  • Array [
    • version string

    The version of the release.

    build_time string

    The time when the package was built.

    release_time string

    The time when the package was released externally.

  • ]
    • 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.

  • ]
    • message string

    Generic response message.

    success boolean

    The response status.

Loading...