/v1/api/ipLists (GET) - BlueCat Edge - Service Point v3.x.x

BlueCat Edge API Guide
Locale
English
Product name
BlueCat Edge
Version
Service Point v3.x.x

Returns all IP lists or multiple selected IP lists by ID. 

GET https://api-<BlueCat.edge.url>/v1/api/ipLists?ids=12345,7789
Authorization: Bearer token

Parameters

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

Successful response

200 OK
Content-Type: application/JSON

[
    {
        "id": "12345",
        "name": "An IP list",
        "description": "IP lists",
        "version": "111-222-333-4444",
        "cidrCount": 5
    },
    {
        "id": "6789",
        "name": "The other IP list",
        "description": "Your second IP list",
        "version": "555-666-777-8888",
        "cidrCount": 20
    }
]
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.

Response on unsuccessful authorization

Possible error codes
  • 400 Bad Request
  • 401 Unauthorized - Missing or invalid token
  • 404 IP List was not found
  • 500 Internal Server Error