/v1/api/ipLists/{id} (GET) - BlueCat DNS Edge

DNS Edge User Guide

Locale
English (United States)
Product name
BlueCat DNS Edge

Returns an IP list by ID.

GET https://api-<DNS.Edge.URL>/v1/api/ipLists/{id}
Authorization: Bearer token

Parameters

Name Description Type Required
id The ID of the IP list. If the ID is not specified, all the IP lists are returned. String Required

Successful response

200 OK
Content-Type: application/JSON

 {
	 "id": "1234567",
	 "name": "IP List 1",
	 "description": "IP list used for blocking",
	 "version": "111-222-333-4444",
	 "cidrCount": 100
 }
Returns the following information:
  • id: The ID of IP list.
  • name: The name of the IP list.
  • description: A description of the IP list.
  • version: The version of the list if modified.
  • cidrCount: The number of CIDR ranges in the list.
Possible error codes
  • 401 Unauthorized - Missing or invalid token
  • 404 IP List was not found
  • 500 Internal Server Error