Focus

Prisma Access

Query Verdicts by IP Address

Table of Contents

Filter

Expand All | Collapse All

Prisma Access Docs

Release Notes
Select a Document
- 6.0 Preferred and Innovation
- 5.2 Preferred and Innovation
- 5.1 Preferred and Innovation
- 5.0 Preferred and Innovation
- 4.2 Preferred
- 4.1 Preferred
- 4.0 Preferred
- 3.2 Preferred and Innovation
- 3.1 Preferred and Innovation
- 3.0 Preferred and Innovation
- 2.2 Preferred
Activation & Onboarding
Administration
Select a Document
- 4.0 & Later
- Prisma Access China
Integrations
Incidents & Alerts

verdicts Object

Query Verdict Statistics

Query Verdicts by IP Address

Retrieves IP address-to-device mappings based on IP address.

Synopsis

URI	/api/v1/token/verdicts?ip={STRING} (recommended API method) /api/v1/token/{apiKey}/verdicts?ip={STRING} (legacy API method)
HTTP Method	GET

Description

Uses IP addresses to return corresponding device mappings. You can retrieve multiple mappings by providing a list of up to 10 IP addresses, separated by commas, appended to the URI.

If the service can't find a mapping associated with an IP address, it won't return a mapping for that IP address.

Success Response

Upon success, the HTTP response code is 200. In addition, the response contains a JSON object with the following fields:

Field	Description
count	Integer representing the number of mappings returned in the response.
verdicts	Object that contains the mappings specified in the request.

For example:

{     
    "count": 1,
    "verdicts" : [
        {   
            "ip": "10.10.10.10",
            "updateTime": 1623974506,
            "mac": "0a:d4:5f:e9:96:10",
            "category": "Smartphone or Tablet",
            "vendor": "Apple Inc.",
            "model": "iPad2",
            "os": "iOS 9.3.6",
            "osFamily": "iOS",
            "profile": "iPad"
        }
    ]
}
}

Error Response

Upon error, the HTTP response code is one of the following:

Response Code	Description
400	Invalid request. The request was incomplete or malformed in some way. Fix the request before retrying.
401	Unauthorized token.
429	Too many requests. The system couldn’t process the request because the system has issued too many requests in a specific period of time. Don't exceed more than one request per second. Wait and try again.

In addition, the response body contains the following fields:

Field	Description
code	The error code.
message	The error message.

verdicts Object

Query Verdict Statistics

Prisma Access Docs

Query Verdicts by IP Address

Prisma Access Docs

Query Verdicts by IP Address

Synopsis

Description

Success Response

Error Response

Activation & Onboarding

SASE

Cloud-Delivered Security Services

Network Security

Endpoints

Visibility & Monitoring

Best Practices

Experts Corner

Translated Documents