Documentation | Support

Go to the table of contents Go to the previous page Go to the next page View or print as PDF
Interfaces > List URLs and IP addresses in an API-managed category
List URLs and IP addresses in an API-managed category
Management API Guide | Forcepoint Web Security | v8.5.x
Use the GET command described in this section to view a list of all committed URLs, IP addresses, and ranges in an API-managed category. URLs and IP addresses in a pending transaction are not returned with this command.
 
Method
URL
Description
GET
https://<ps_ip_address>:15873/api/web/v1/categories/urls?catname=<category_name>
or
https://<ps_ip_address>:15873/api/web/v1/categories/urls?catid=<category_id>
Lists all URLs, IP addresses, and ranges in the specified category.
The category may be specified by name or ID.
JSON response for viewing URLs and IP addresses
Each entry has the category name and ID, followed by a list of URLs, then a list of IP addresses and ranges.
{
"Category Name":"Malicious DEF",
"Category ID":1945,
"URLs":
[
"http://www.test1.com/test1",
"http://www.test1.com/test2",
"http://www.test1.com/test3"
],
"IPs":
[
"167.34.15.117",
"167.34.16.118-167.34.16.120",
"2045:1221:1231::1331"
"24.56.8.0/23,
"55AF:F451::/32
]
}
Response codes
 
200
OK (request succeeded)
400
Bad request
403
Authentication failed
409
Bad category ID or name
500
Internal server error
JSON for bad request
{
"Error" :
[
"Unable to access URL data",
"Other Error Messages"
]
}

Go to the table of contents Go to the previous page Go to the next page View or print as PDF
Interfaces > List URLs and IP addresses in an API-managed category
Copyright 2022 Forcepoint. All rights reserved.