VIP Device

Query and manage (add/update/remove) VIP Device data.
DEVICE ID (i.e. 5F67753832224611BF697A590316AA34) and STATUS (i.e. R, E, D, A) values must be upper case

Endpoints

/rpc/v1/vip/device.html
The browsable documentation for this API endpoint.
/rpc/v1/vip/device.json
Endpoint that will return a JSON response.
/rpc/v1/vip/device.xml
Endpoint that will return an XML response.

Usage

Usage for HTTP GET

Key Name: device
Perform a VIP lookup on the provided device id.
The status code (review, decline, etc) will be returned for the given device.
Example:
device_id=DEVICE_ID

Usage for HTTP POST

Key Name: device[DEVICE_ID]
Brackets contain a device id. Key values: A|R|D|X for setting status to approve, review, decline, or delete.
Must provide at least one device id with a valid status.
Examples:
device_id[DEVICE_ID]=A
device_id[DEVICE_ID]=R
device_id[DEVICE_ID]=D
device_id[DEVICE_ID]=X

Some examples using curl are provided below.

Error Codes

206 Partial Success
In batch requests, this signifies that there were a mix of successes and failures.
400 Validation
Incorrect/Invalid input data.
401 Authentication
The key provided could not be authenticated

Response Samples

Successful Response: GET [XML]
<?xml version="1.0" encoding="UTF-8"?>
<response>
 <status>ok</status>
 <count>
  <success>1</success>
  <failure>0</failure>
 </count>
 <errors/>
 <result>decline</result>
</response>
Successful Response: GET [JSON]
{"status":"ok","count":{"success":1,"failure":0},"errors":[],"result":"decline"}

Code Examples

GET
curl -G \
   -d "device_id=DEVICE_ID" \
   -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
   https://api.kount.net/rpc/v1/vip/device.json
POST
curl -d "device_id[DEVICE_ID]=D" \
     -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/device.json
POST (batch)
curl -d "device_id[DEVICE_ID]=R" \
     -d "device_id[DEVICE_ID]=E" \
     -d "device_id[DEVICE_ID]=A" \ -H "X-Kount-Api-Key: XXX.YYY.ZZZ" \
     https://api.kount.net/rpc/v1/vip/device.json