Returns all IP lists or multiple selected IP lists by ID.
GET https://api-<DNS.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