{
"isBogon": [
{
"ip": "0.0.0.0",
"expect": true,
"why": "this network"
},
{
"ip": "10.0.0.1",
"expect": true,
"why": "RFC 1918"
},
{
"ip": "100.64.0.1",
"expect": true,
"why": "carrier-grade NAT"
},
{
"ip": "127.0.0.1",
"expect": true,
"why": "loopback"
},
{
"ip": "169.254.1.1",
"expect": true,
"why": "link-local"
},
{
"ip": "172.16.5.4",
"expect": true,
"why": "RFC 1918"
},
{
"ip": "192.0.2.1",
"expect": true,
"why": "documentation"
},
{
"ip": "192.168.1.1",
"expect": true,
"why": "RFC 1918"
},
{
"ip": "198.18.0.1",
"expect": true,
"why": "benchmarking"
},
{
"ip": "203.0.113.9",
"expect": true,
"why": "documentation"
},
{
"ip": "224.0.0.1",
"expect": true,
"why": "multicast"
},
{
"ip": "255.255.255.255",
"expect": true,
"why": "broadcast"
},
{
"ip": "1.1.1.1",
"expect": false,
"why": "ordinary public address"
},
{
"ip": "8.8.8.8",
"expect": false,
"why": "ordinary public address"
},
{
"ip": "172.32.0.1",
"expect": false,
"why": "just outside 172.16.0.0/12"
},
{
"ip": "100.128.0.1",
"expect": false,
"why": "just outside 100.64.0.0/10"
},
{
"ip": "::1",
"expect": true,
"why": "v6 loopback"
},
{
"ip": "fe80::1",
"expect": true,
"why": "v6 link-local"
},
{
"ip": "fc00::1",
"expect": true,
"why": "v6 unique local"
},
{
"ip": "2001:db8::1",
"expect": true,
"why": "v6 documentation"
},
{
"ip": "ff02::1",
"expect": true,
"why": "v6 multicast"
},
{
"ip": "2002:a00::1",
"expect": true,
"why": "6to4 wrapping 10.0.0.0/8"
},
{
"ip": "2002:7f00::1",
"expect": true,
"why": "6to4 wrapping 127.0.0.0/8"
},
{
"ip": "2001:0:a00::1",
"expect": true,
"why": "teredo wrapping 10.0.0.0/8"
},
{
"ip": "2606:4700:4700::1111",
"expect": false,
"why": "ordinary public v6"
},
{
"ip": "2400:cb00::1",
"expect": false,
"why": "ordinary public v6"
},
{
"ip": "fdff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside fc00::/7; pins the /7 mask width"
},
{
"ip": "fe00::",
"expect": true,
"why": "past fc00::/7 but inside e000::/3, outside global unicast"
},
{
"ip": "3fff:fff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 3fff::/20; pins the /20 mask width"
},
{
"ip": "3fff:1000::",
"expect": false,
"why": "first address past 3fff::/20; a mask one bit too wide claims it"
},
{
"ip": "2001:db8:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 2001:db8::/32; pins the /32 mask width"
},
{
"ip": "2001:db9::",
"expect": false,
"why": "first address past 2001:db8::/32; a mask one bit too wide claims it"
},
{
"ip": "2002:a9fe:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 2002:a9fe::/32; pins the /32 mask width"
},
{
"ip": "2002:a9ff::",
"expect": false,
"why": "first address past 2002:a9fe::/32; a mask one bit too wide claims it"
},
{
"ip": "2001:0:c000:2ff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 2001:0:c000:200::/56; pins the /56 mask width"
},
{
"ip": "2001:0:c000:300::",
"expect": false,
"why": "first address past 2001:0:c000:200::/56; a mask one bit too wide claims it"
},
{
"ip": "100::ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 100::/64; pins the /64 mask width"
},
{
"ip": "100:0:0:1::",
"expect": true,
"why": "past 100::/64 but inside 100:0:0:1::/64 and ::/3"
},
{
"ip": "2001:1ff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address inside 2001::/23; pins the /23 mask width"
},
{
"ip": "2001:200::",
"expect": false,
"why": "first address past 2001::/23; a mask one bit too wide claims it"
},
{
"ip": "10.255.255.255",
"expect": true,
"why": "last address inside 10.0.0.0/8; pins the /8 mask width"
},
{
"ip": "11.0.0.0",
"expect": false,
"why": "first address past 10.0.0.0/8; a mask one bit too wide claims it"
},
{
"ip": "100.127.255.255",
"expect": true,
"why": "last address inside 100.64.0.0/10; pins the /10 mask width"
},
{
"ip": "100.128.0.0",
"expect": false,
"why": "first address past 100.64.0.0/10; a mask one bit too wide claims it"
},
{
"ip": "172.31.255.255",
"expect": true,
"why": "last address inside 172.16.0.0/12; pins the /12 mask width"
},
{
"ip": "172.32.0.0",
"expect": false,
"why": "first address past 172.16.0.0/12; a mask one bit too wide claims it"
},
{
"ip": "198.19.255.255",
"expect": true,
"why": "last address inside 198.18.0.0/15; pins the /15 mask width"
},
{
"ip": "198.20.0.0",
"expect": false,
"why": "first address past 198.18.0.0/15; a mask one bit too wide claims it"
},
{
"ip": "192.0.2.255",
"expect": true,
"why": "last address inside 192.0.2.0/24; pins the /24 mask width"
},
{
"ip": "192.0.3.0",
"expect": false,
"why": "first address past 192.0.2.0/24; a mask one bit too wide claims it"
},
{
"ip": "0.255.255.255",
"expect": true,
"why": "last address of 0.0.0.0/8"
},
{
"ip": "1.0.0.0",
"expect": false,
"why": "just above 0.0.0.0/8"
},
{
"ip": "10.0.0.0",
"expect": true,
"why": "first address of 10.0.0.0/8"
},
{
"ip": "9.255.255.255",
"expect": false,
"why": "just below 10.0.0.0/8"
},
{
"ip": "100.64.0.0",
"expect": true,
"why": "first address of 100.64.0.0/10"
},
{
"ip": "100.63.255.255",
"expect": false,
"why": "just below 100.64.0.0/10"
},
{
"ip": "127.0.0.0",
"expect": true,
"why": "first address of 127.0.0.0/8"
},
{
"ip": "127.255.255.255",
"expect": true,
"why": "last address of 127.0.0.0/8"
},
{
"ip": "126.255.255.255",
"expect": false,
"why": "just below 127.0.0.0/8"
},
{
"ip": "128.0.0.0",
"expect": false,
"why": "just above 127.0.0.0/8"
},
{
"ip": "169.254.0.0",
"expect": true,
"why": "first address of 169.254.0.0/16"
},
{
"ip": "169.254.255.255",
"expect": true,
"why": "last address of 169.254.0.0/16"
},
{
"ip": "169.253.255.255",
"expect": false,
"why": "just below 169.254.0.0/16"
},
{
"ip": "169.255.0.0",
"expect": false,
"why": "just above 169.254.0.0/16"
},
{
"ip": "172.16.0.0",
"expect": true,
"why": "first address of 172.16.0.0/12"
},
{
"ip": "172.15.255.255",
"expect": false,
"why": "just below 172.16.0.0/12"
},
{
"ip": "192.0.0.0",
"expect": true,
"why": "first address of 192.0.0.0/24"
},
{
"ip": "192.0.0.255",
"expect": true,
"why": "last address of 192.0.0.0/24"
},
{
"ip": "191.255.255.255",
"expect": false,
"why": "just below 192.0.0.0/24"
},
{
"ip": "192.0.1.0",
"expect": false,
"why": "just above 192.0.0.0/24"
},
{
"ip": "192.0.2.0",
"expect": true,
"why": "first address of 192.0.2.0/24"
},
{
"ip": "192.0.1.255",
"expect": false,
"why": "just below 192.0.2.0/24"
},
{
"ip": "192.88.99.2",
"expect": true,
"why": "first address of 192.88.99.2/32"
},
{
"ip": "192.88.99.1",
"expect": false,
"why": "just below 192.88.99.2/32"
},
{
"ip": "192.88.99.3",
"expect": false,
"why": "just above 192.88.99.2/32"
},
{
"ip": "192.168.0.0",
"expect": true,
"why": "first address of 192.168.0.0/16"
},
{
"ip": "192.168.255.255",
"expect": true,
"why": "last address of 192.168.0.0/16"
},
{
"ip": "192.167.255.255",
"expect": false,
"why": "just below 192.168.0.0/16"
},
{
"ip": "192.169.0.0",
"expect": false,
"why": "just above 192.168.0.0/16"
},
{
"ip": "198.18.0.0",
"expect": true,
"why": "first address of 198.18.0.0/15"
},
{
"ip": "198.17.255.255",
"expect": false,
"why": "just below 198.18.0.0/15"
},
{
"ip": "198.51.100.0",
"expect": true,
"why": "first address of 198.51.100.0/24"
},
{
"ip": "198.51.100.255",
"expect": true,
"why": "last address of 198.51.100.0/24"
},
{
"ip": "198.51.99.255",
"expect": false,
"why": "just below 198.51.100.0/24"
},
{
"ip": "198.51.101.0",
"expect": false,
"why": "just above 198.51.100.0/24"
},
{
"ip": "203.0.113.0",
"expect": true,
"why": "first address of 203.0.113.0/24"
},
{
"ip": "203.0.113.255",
"expect": true,
"why": "last address of 203.0.113.0/24"
},
{
"ip": "203.0.112.255",
"expect": false,
"why": "just below 203.0.113.0/24"
},
{
"ip": "203.0.114.0",
"expect": false,
"why": "just above 203.0.113.0/24"
},
{
"ip": "224.0.0.0",
"expect": true,
"why": "first address of 224.0.0.0/4"
},
{
"ip": "239.255.255.255",
"expect": true,
"why": "last address of 224.0.0.0/4"
},
{
"ip": "223.255.255.255",
"expect": false,
"why": "just below 224.0.0.0/4"
},
{
"ip": "240.0.0.0",
"expect": true,
"why": "just above 224.0.0.0/4"
},
{
"ip": "255.255.255.254",
"expect": true,
"why": "just below 255.255.255.255/32"
},
{
"ip": "::",
"expect": true,
"why": "first address of ::/128"
},
{
"ip": "::2",
"expect": true,
"why": "just above ::1/128"
},
{
"ip": "::fffe:ffff:ffff",
"expect": true,
"why": "just below ::ffff:0:0/96"
},
{
"ip": "::1:0:0:0",
"expect": true,
"why": "just above ::ffff:0:0/96"
},
{
"ip": "::ffff:ffff",
"expect": true,
"why": "last address of ::/96"
},
{
"ip": "::1:0:0",
"expect": true,
"why": "just above ::/96"
},
{
"ip": "64:ff9b::",
"expect": true,
"why": "first address of 64:ff9b::/96"
},
{
"ip": "64:ff9b::ffff:ffff",
"expect": true,
"why": "last address of 64:ff9b::/96"
},
{
"ip": "64:ff9a:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 64:ff9b::/96"
},
{
"ip": "64:ff9b::1:0:0",
"expect": true,
"why": "just above 64:ff9b::/96"
},
{
"ip": "64:ff9b:1::",
"expect": true,
"why": "first address of 64:ff9b:1::/48"
},
{
"ip": "64:ff9b:1:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 64:ff9b:1::/48"
},
{
"ip": "64:ff9b:0:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 64:ff9b:1::/48"
},
{
"ip": "64:ff9b:2::",
"expect": true,
"why": "just above 64:ff9b:1::/48"
},
{
"ip": "100::",
"expect": true,
"why": "first address of 100::/64"
},
{
"ip": "ff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 100::/64"
},
{
"ip": "100::1:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 100:0:0:1::/64"
},
{
"ip": "100:0:0:2::",
"expect": true,
"why": "just above 100:0:0:1::/64"
},
{
"ip": "2001:2::",
"expect": true,
"why": "first address of 2001:2::/48"
},
{
"ip": "2001:2:0:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:2::/48"
},
{
"ip": "2001:1:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 2001:2::/48"
},
{
"ip": "2001:2:1::",
"expect": true,
"why": "just above 2001:2::/48"
},
{
"ip": "2001:10::",
"expect": true,
"why": "first address of 2001:10::/28"
},
{
"ip": "2001:1f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:10::/28"
},
{
"ip": "2001:f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 2001:10::/28"
},
{
"ip": "2001:20::",
"expect": true,
"why": "just above 2001:10::/28"
},
{
"ip": "2001:db8::",
"expect": true,
"why": "first address of 2001:db8::/32"
},
{
"ip": "2001:db7:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:db8::/32"
},
{
"ip": "3fff::",
"expect": true,
"why": "first address of 3fff::/20"
},
{
"ip": "3ffe:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 3fff::/20"
},
{
"ip": "5f00::",
"expect": true,
"why": "first address of 5f00::/16"
},
{
"ip": "5f00:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 5f00::/16"
},
{
"ip": "5eff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 5f00::/16"
},
{
"ip": "5f01::",
"expect": true,
"why": "just above 5f00::/16"
},
{
"ip": "fc00::",
"expect": true,
"why": "first address of fc00::/7"
},
{
"ip": "fbff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below fc00::/7"
},
{
"ip": "fe80::",
"expect": true,
"why": "first address of fe80::/10"
},
{
"ip": "febf:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of fe80::/10"
},
{
"ip": "fe7f:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below fe80::/10"
},
{
"ip": "fec0::",
"expect": true,
"why": "just above fe80::/10"
},
{
"ip": "feff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of fec0::/10"
},
{
"ip": "ff00::",
"expect": true,
"why": "just above fec0::/10"
},
{
"ip": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of ff00::/8"
},
{
"ip": "2002::",
"expect": true,
"why": "first address of 2002::/24"
},
{
"ip": "2002:ff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002::/24"
},
{
"ip": "2001:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002::/24"
},
{
"ip": "2002:100::",
"expect": false,
"why": "just above 2002::/24"
},
{
"ip": "2002:a00::",
"expect": true,
"why": "first address of 2002:a00::/24"
},
{
"ip": "2002:aff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:a00::/24"
},
{
"ip": "2002:9ff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:a00::/24"
},
{
"ip": "2002:b00::",
"expect": false,
"why": "just above 2002:a00::/24"
},
{
"ip": "2002:6440::",
"expect": true,
"why": "first address of 2002:6440::/26"
},
{
"ip": "2002:647f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:6440::/26"
},
{
"ip": "2002:643f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:6440::/26"
},
{
"ip": "2002:6480::",
"expect": false,
"why": "just above 2002:6440::/26"
},
{
"ip": "2002:7f00::",
"expect": true,
"why": "first address of 2002:7f00::/24"
},
{
"ip": "2002:7fff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:7f00::/24"
},
{
"ip": "2002:7eff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:7f00::/24"
},
{
"ip": "2002:8000::",
"expect": false,
"why": "just above 2002:7f00::/24"
},
{
"ip": "2002:a9fe::",
"expect": true,
"why": "first address of 2002:a9fe::/32"
},
{
"ip": "2002:a9fd:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:a9fe::/32"
},
{
"ip": "2002:ac10::",
"expect": true,
"why": "first address of 2002:ac10::/28"
},
{
"ip": "2002:ac1f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:ac10::/28"
},
{
"ip": "2002:ac0f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:ac10::/28"
},
{
"ip": "2002:ac20::",
"expect": false,
"why": "just above 2002:ac10::/28"
},
{
"ip": "2002:c000::",
"expect": true,
"why": "first address of 2002:c000::/40"
},
{
"ip": "2002:c000:ff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c000::/40"
},
{
"ip": "2002:bfff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c000::/40"
},
{
"ip": "2002:c000:100::",
"expect": false,
"why": "just above 2002:c000::/40"
},
{
"ip": "2002:c000:200::",
"expect": true,
"why": "first address of 2002:c000:200::/40"
},
{
"ip": "2002:c000:2ff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c000:200::/40"
},
{
"ip": "2002:c000:1ff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c000:200::/40"
},
{
"ip": "2002:c000:300::",
"expect": false,
"why": "just above 2002:c000:200::/40"
},
{
"ip": "2002:c058:6302::",
"expect": true,
"why": "first address of 2002:c058:6302::/48"
},
{
"ip": "2002:c058:6302:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c058:6302::/48"
},
{
"ip": "2002:c058:6301:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c058:6302::/48"
},
{
"ip": "2002:c058:6303::",
"expect": false,
"why": "just above 2002:c058:6302::/48"
},
{
"ip": "2002:c0a8::",
"expect": true,
"why": "first address of 2002:c0a8::/32"
},
{
"ip": "2002:c0a8:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c0a8::/32"
},
{
"ip": "2002:c0a7:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c0a8::/32"
},
{
"ip": "2002:c0a9::",
"expect": false,
"why": "just above 2002:c0a8::/32"
},
{
"ip": "2002:c612::",
"expect": true,
"why": "first address of 2002:c612::/31"
},
{
"ip": "2002:c613:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c612::/31"
},
{
"ip": "2002:c611:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c612::/31"
},
{
"ip": "2002:c614::",
"expect": false,
"why": "just above 2002:c612::/31"
},
{
"ip": "2002:c633:6400::",
"expect": true,
"why": "first address of 2002:c633:6400::/40"
},
{
"ip": "2002:c633:64ff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:c633:6400::/40"
},
{
"ip": "2002:c633:63ff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:c633:6400::/40"
},
{
"ip": "2002:c633:6500::",
"expect": false,
"why": "just above 2002:c633:6400::/40"
},
{
"ip": "2002:cb00:7100::",
"expect": true,
"why": "first address of 2002:cb00:7100::/40"
},
{
"ip": "2002:cb00:71ff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:cb00:7100::/40"
},
{
"ip": "2002:cb00:70ff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:cb00:7100::/40"
},
{
"ip": "2002:cb00:7200::",
"expect": false,
"why": "just above 2002:cb00:7100::/40"
},
{
"ip": "2002:e000::",
"expect": true,
"why": "first address of 2002:e000::/20"
},
{
"ip": "2002:efff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:e000::/20"
},
{
"ip": "2002:dfff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2002:e000::/20"
},
{
"ip": "2002:f000::",
"expect": true,
"why": "just above 2002:e000::/20"
},
{
"ip": "2002:ffff:ffff::",
"expect": true,
"why": "first address of 2002:ffff:ffff::/48"
},
{
"ip": "2002:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2002:ffff:ffff::/48"
},
{
"ip": "2002:ffff:fffe:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 2002:ffff:ffff::/48"
},
{
"ip": "2003::",
"expect": false,
"why": "just above 2002:ffff:ffff::/48"
},
{
"ip": "2001::",
"expect": true,
"why": "first address of 2001::/40"
},
{
"ip": "2001:0:ff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001::/40"
},
{
"ip": "2000:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001::/40"
},
{
"ip": "2001:0:100::",
"expect": false,
"why": "just above 2001::/40"
},
{
"ip": "2001:0:a00::",
"expect": true,
"why": "first address of 2001:0:a00::/40"
},
{
"ip": "2001:0:aff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:a00::/40"
},
{
"ip": "2001:0:9ff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:a00::/40"
},
{
"ip": "2001:0:b00::",
"expect": false,
"why": "just above 2001:0:a00::/40"
},
{
"ip": "2001:0:6440::",
"expect": true,
"why": "first address of 2001:0:6440::/42"
},
{
"ip": "2001:0:647f:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:6440::/42"
},
{
"ip": "2001:0:643f:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:6440::/42"
},
{
"ip": "2001:0:6480::",
"expect": false,
"why": "just above 2001:0:6440::/42"
},
{
"ip": "2001:0:7f00::",
"expect": true,
"why": "first address of 2001:0:7f00::/40"
},
{
"ip": "2001:0:7fff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:7f00::/40"
},
{
"ip": "2001:0:7eff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:7f00::/40"
},
{
"ip": "2001:0:8000::",
"expect": false,
"why": "just above 2001:0:7f00::/40"
},
{
"ip": "2001:0:a9fe::",
"expect": true,
"why": "first address of 2001:0:a9fe::/48"
},
{
"ip": "2001:0:a9fe:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:a9fe::/48"
},
{
"ip": "2001:0:a9fd:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:a9fe::/48"
},
{
"ip": "2001:0:a9ff::",
"expect": false,
"why": "just above 2001:0:a9fe::/48"
},
{
"ip": "2001:0:ac10::",
"expect": true,
"why": "first address of 2001:0:ac10::/44"
},
{
"ip": "2001:0:ac1f:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:ac10::/44"
},
{
"ip": "2001:0:ac0f:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:ac10::/44"
},
{
"ip": "2001:0:ac20::",
"expect": false,
"why": "just above 2001:0:ac10::/44"
},
{
"ip": "2001:0:c000::",
"expect": true,
"why": "first address of 2001:0:c000::/56"
},
{
"ip": "2001:0:c000:ff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:c000::/56"
},
{
"ip": "2001:0:bfff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c000::/56"
},
{
"ip": "2001:0:c000:100::",
"expect": false,
"why": "just above 2001:0:c000::/56"
},
{
"ip": "2001:0:c000:200::",
"expect": true,
"why": "first address of 2001:0:c000:200::/56"
},
{
"ip": "2001:0:c000:1ff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c000:200::/56"
},
{
"ip": "2001:0:c058:6302::",
"expect": true,
"why": "first address of 2001:0:c058:6302::/64"
},
{
"ip": "2001:0:c058:6302:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:c058:6302::/64"
},
{
"ip": "2001:0:c058:6301:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c058:6302::/64"
},
{
"ip": "2001:0:c058:6303::",
"expect": false,
"why": "just above 2001:0:c058:6302::/64"
},
{
"ip": "2001:0:c0a8::",
"expect": true,
"why": "first address of 2001:0:c0a8::/48"
},
{
"ip": "2001:0:c0a8:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:c0a8::/48"
},
{
"ip": "2001:0:c0a7:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c0a8::/48"
},
{
"ip": "2001:0:c0a9::",
"expect": false,
"why": "just above 2001:0:c0a8::/48"
},
{
"ip": "2001:0:c612::",
"expect": true,
"why": "first address of 2001:0:c612::/47"
},
{
"ip": "2001:0:c613:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:c612::/47"
},
{
"ip": "2001:0:c611:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c612::/47"
},
{
"ip": "2001:0:c614::",
"expect": false,
"why": "just above 2001:0:c612::/47"
},
{
"ip": "2001:0:c633:6400::",
"expect": true,
"why": "first address of 2001:0:c633:6400::/56"
},
{
"ip": "2001:0:c633:64ff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:c633:6400::/56"
},
{
"ip": "2001:0:c633:63ff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:c633:6400::/56"
},
{
"ip": "2001:0:c633:6500::",
"expect": false,
"why": "just above 2001:0:c633:6400::/56"
},
{
"ip": "2001:0:cb00:7100::",
"expect": true,
"why": "first address of 2001:0:cb00:7100::/56"
},
{
"ip": "2001:0:cb00:71ff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:cb00:7100::/56"
},
{
"ip": "2001:0:cb00:70ff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:cb00:7100::/56"
},
{
"ip": "2001:0:cb00:7200::",
"expect": false,
"why": "just above 2001:0:cb00:7100::/56"
},
{
"ip": "2001:0:e000::",
"expect": true,
"why": "first address of 2001:0:e000::/36"
},
{
"ip": "2001:0:efff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:e000::/36"
},
{
"ip": "2001:0:dfff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 2001:0:e000::/36"
},
{
"ip": "2001:0:f000::",
"expect": true,
"why": "just above 2001:0:e000::/36"
},
{
"ip": "2001:0:ffff:ffff::",
"expect": true,
"why": "first address of 2001:0:ffff:ffff::/64"
},
{
"ip": "2001:0:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:0:ffff:ffff::/64"
},
{
"ip": "2001:0:ffff:fffe:ffff:ffff:ffff:ffff",
"expect": true,
"why": "just below 2001:0:ffff:ffff::/64"
},
{
"ip": "2001:1::",
"expect": true,
"why": "just above 2001:0:ffff:ffff::/64"
},
{
"ip": "2001:3:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:2::/31"
},
{
"ip": "2001:4::",
"expect": true,
"why": "just above 2001:2::/31"
},
{
"ip": "2001:7:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:4::/30"
},
{
"ip": "2001:8::",
"expect": true,
"why": "just above 2001:4::/30"
},
{
"ip": "2001:3f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:20::/27"
},
{
"ip": "2001:40::",
"expect": true,
"why": "just above 2001:20::/27"
},
{
"ip": "2001:7f:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:40::/26"
},
{
"ip": "2001:80::",
"expect": true,
"why": "just above 2001:40::/26"
},
{
"ip": "2001:ff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 2001:80::/25"
},
{
"ip": "2001:100::",
"expect": true,
"why": "just above 2001:80::/25"
},
{
"ip": "1fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of ::/3"
},
{
"ip": "2000::",
"expect": false,
"why": "just above ::/3"
},
{
"ip": "4000::",
"expect": true,
"why": "first address of 4000::/3"
},
{
"ip": "5fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 4000::/3"
},
{
"ip": "3fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": false,
"why": "just below 4000::/3"
},
{
"ip": "6000::",
"expect": true,
"why": "just above 4000::/3"
},
{
"ip": "7fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 6000::/3"
},
{
"ip": "8000::",
"expect": true,
"why": "just above 6000::/3"
},
{
"ip": "9fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of 8000::/3"
},
{
"ip": "a000::",
"expect": true,
"why": "just above 8000::/3"
},
{
"ip": "bfff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of a000::/3"
},
{
"ip": "c000::",
"expect": true,
"why": "just above a000::/3"
},
{
"ip": "dfff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
"expect": true,
"why": "last address of c000::/3"
},
{
"ip": "e000::",
"expect": true,
"why": "just above c000::/3"
}
],
"ipv4Mapped": [
{
"ip": "::ffff:8.8.8.8",
"carries": "8.8.8.8",
"expect": false,
"why": "a public IPv4 visitor, as a server listening on :: sees every one: judged, sent and cached as 8.8.8.8, never as a bogon in ::ffff:0:0/96"
},
{
"ip": "::ffff:10.0.0.1",
"carries": "10.0.0.1",
"expect": true,
"why": "RFC 1918, mapped: a bogon for the same reason 10.0.0.1 is"
},
{
"ip": "::ffff:127.0.0.1",
"carries": "127.0.0.1",
"expect": true,
"why": "loopback, mapped: a local client of a server listening on ::"
},
{
"ip": "::ffff:808:808",
"carries": "8.8.8.8",
"expect": false,
"why": "the same address with its IPv4 half in hex"
},
{
"ip": "0:0:0:0:0:ffff:808:808",
"carries": "8.8.8.8",
"expect": false,
"why": "the same address written in full"
},
{
"ip": "::FFFF:8.8.8.8",
"carries": "8.8.8.8",
"expect": false,
"why": "upper-case hex digits"
},
{
"ip": "::8.8.8.8",
"carries": "::8.8.8.8",
"expect": true,
"why": "IPv4-compatible, not mapped: stays IPv6 and inside ::/96"
}
],
"bogonResponse": {
"why": "A bogon is answered locally in the full shape. Every flag is present and false, every detail object is present and empty, web is an empty list, location, asn, company and abuse carry every key empty or zero as the API answers a bogon (asn 0, latitude 0, strings empty, validated false), hostname is an empty string, and is_bogon is true, as the API answers reserved space; the SDK computes it rather than asking.",
"flagsFalse": [
"is_vpn",
"is_hosting",
"is_relay",
"is_tor",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"is_pubproxy",
"is_anycast",
"is_carrier",
"is_satellite",
"is_ssh",
"is_smtp",
"is_web",
"is_dns_resolver",
"is_bittorrent"
],
"emptyObjects": [
"vpn",
"hosting",
"relay",
"tor",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy",
"carrier",
"satellite",
"ssh",
"smtp",
"dns_resolver",
"bittorrent"
],
"location": {
"continent": "",
"continent_name": "",
"country": "",
"country_name": "",
"timezone": "",
"currency_code": "",
"currency_name": "",
"currency_symbol": "",
"flag_emoji": "",
"flag_unicode": "",
"region": "",
"region_code": "",
"city": "",
"postal_code": "",
"latitude": 0,
"longitude": 0,
"accuracy_radius": 0,
"geoname_id": "",
"dma_code": "",
"last_changed": ""
},
"asn": {
"asn": 0,
"name": "",
"domain": "",
"type": "",
"prefix": "",
"country": "",
"rpki_status": ""
},
"web": [],
"hostname": "",
"company": {
"name": "",
"domain": "",
"type": "",
"country": ""
},
"abuse": {
"email": "",
"name": "",
"phone": "",
"address": "",
"country": "",
"network": "",
"validated": false,
"unvalidated_since": ""
}
},
"lookup": [
{
"name": "required-only-not-vpn",
"why": "Only the two members every answer must carry. Every other member is absent, which means not in this answer and must not read as false.",
"status": 200,
"body": {
"ip": "1.1.1.1",
"is_vpn": false
},
"expect": {
"ip": "1.1.1.1",
"isBogon": false,
"present": {
"is_vpn": false
},
"absent": [
"is_hosting",
"is_relay",
"is_tor",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"vpn",
"hosting",
"relay",
"tor",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"is_pubproxy",
"pubproxy",
"trial_expired"
]
}
},
{
"name": "starter-vpn-hit",
"why": "Starter buys the vpn object and the four classification FLAGS, but none of their detail objects.",
"status": 200,
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"vpn": {
"provider": "mullvad",
"last_seen": "2026-09-02"
}
},
"expect": {
"ip": "45.83.91.1",
"isBogon": false,
"present": {
"is_vpn": true,
"is_hosting": true,
"is_relay": false
},
"absent": [
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"hosting",
"relay",
"tor",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"is_pubproxy",
"pubproxy"
],
"vpn": {
"provider": "mullvad",
"last_seen": "2026-09-02"
}
}
},
{
"name": "scale-empty-object-means-flag-false",
"why": "An empty detail object beside a false flag means not-found. It must not be confused with an absent member.",
"status": 200,
"body": {
"ip": "8.8.8.8",
"is_vpn": false,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"vpn": {},
"hosting": {
"provider": "Google",
"confidence": "high",
"last_seen": "2026-09-02"
},
"relay": {},
"tor": {},
"cdn": {}
},
"expect": {
"ip": "8.8.8.8",
"isBogon": false,
"present": {
"is_vpn": false,
"is_hosting": true,
"is_tor": false
},
"absent": [
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"resproxy",
"dcproxy",
"mobproxy",
"is_pubproxy",
"pubproxy"
],
"emptyPresent": [
"vpn",
"relay",
"tor",
"cdn"
],
"hosting": {
"provider": "Google",
"confidence": "high",
"last_seen": "2026-09-02"
}
}
},
{
"name": "max-full-shape",
"why": "Max adds confidence and method on vpn, plus the three proxy families and the public proxy detail. A served answer carries is_bogon, and a detail with a provider carries provider_name, the catalog's name beside its ID. A paid key's answer carries cap_reached, false while the answer has every field.",
"status": 200,
"body": {
"ip": "45.83.91.1",
"is_bogon": false,
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": true,
"is_mobproxy": false,
"is_pubproxy": true,
"vpn": {
"provider": "mullvad",
"provider_name": "Mullvad",
"last_seen": "2026-09-02",
"confidence": "high",
"method": "scan"
},
"hosting": {
"provider": "m247",
"provider_name": "M247",
"confidence": "high",
"last_seen": "2026-09-02"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {
"provider": "brightdata",
"provider_name": "Bright Data",
"first_seen": "2026-06-14",
"last_seen": "2026-09-02",
"hits": 42,
"hits_days_pct": 63,
"providers_num": 2
},
"mobproxy": {},
"pubproxy": {
"entry": true,
"exit": true,
"protocols": [
"http",
"https"
],
"num_ports": 3,
"num_proxies": 2,
"last_seen": "2026-10-17",
"last_usable": ""
},
"cap_reached": false
},
"expect": {
"ip": "45.83.91.1",
"isBogon": false,
"present": {
"is_vpn": true,
"is_dcproxy": true,
"is_resproxy": false,
"is_pubproxy": true,
"cap_reached": false
},
"absent": [],
"vpn": {
"provider": "mullvad",
"provider_name": "Mullvad",
"last_seen": "2026-09-02",
"confidence": "high",
"method": "scan"
},
"hosting": {
"provider": "m247",
"provider_name": "M247",
"confidence": "high",
"last_seen": "2026-09-02"
},
"dcproxy": {
"provider": "brightdata",
"provider_name": "Bright Data",
"first_seen": "2026-06-14",
"last_seen": "2026-09-02",
"hits": 42,
"hits_days_pct": 63,
"providers_num": 2
},
"pubproxy": {
"entry": true,
"exit": true,
"protocols": [
"http",
"https"
],
"num_ports": 3,
"num_proxies": 2,
"last_seen": "2026-10-17",
"last_usable": ""
}
}
},
{
"name": "unattributed-range-keeps-empty-provider",
"why": "A populated object always carries every key. An unattributed range has an empty provider string, never a missing one, and an empty provider_name with it.",
"status": 200,
"body": {
"ip": "185.199.1.1",
"is_vpn": true,
"vpn": {
"provider": "",
"provider_name": "",
"last_seen": "2026-08-30"
}
},
"expect": {
"ip": "185.199.1.1",
"isBogon": false,
"present": {
"is_vpn": true
},
"vpn": {
"provider": "",
"provider_name": "",
"last_seen": "2026-08-30"
}
}
},
{
"name": "max-nothing-found",
"why": "A served all-negative Max answer. This is the only case that pins EVERY tier-gated flag as present-and-false, so a per-field slip that maps on truthiness rather than presence cannot hide behind the members other cases happen to set true.",
"status": 200,
"body": {
"ip": "8.8.4.4",
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"vpn": {},
"hosting": {},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {},
"pubproxy": {}
},
"expect": {
"ip": "8.8.4.4",
"isBogon": false,
"present": {
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false
},
"absent": [
"trial_expired"
],
"emptyPresent": [
"vpn",
"hosting",
"relay",
"tor",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy"
]
}
},
{
"name": "unlimited-location-asn",
"why": "The Unlimited tier's answer, with a key or without one: Tor and relay beside the VPN flag, and where the address is and which AS announces it. location and asn carry every key whenever present, so each maps whole.",
"status": 200,
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"expect": {
"ip": "146.70.116.130",
"isBogon": false,
"present": {
"is_vpn": true,
"is_relay": false,
"is_tor": false
},
"absent": [
"is_hosting",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"is_pubproxy",
"vpn",
"hosting",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy",
"trial_expired"
],
"emptyPresent": [
"relay",
"tor"
],
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
}
},
{
"name": "flags-without-detail",
"why": "Every flag, but no detail object behind the six flags past the Unlimited tier's and no vpn object. Each flag maps on its own, and the detail it lacks stays absent rather than empty.",
"status": 200,
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"expect": {
"ip": "146.70.116.130",
"isBogon": false,
"present": {
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false
},
"absent": [
"vpn",
"hosting",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy"
],
"emptyPresent": [
"relay",
"tor"
],
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
}
},
{
"name": "trial-full-answer",
"why": "A free-plan key within its trial: every field, as a paid plan answers it, and trial_expired false. trial_expired maps on presence like any flag.",
"status": 200,
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"vpn": {
"provider": "mullvad",
"last_seen": "2026-09-02",
"confidence": "high"
},
"hosting": {
"provider": "m247",
"confidence": "high",
"last_seen": "2026-09-02"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {},
"pubproxy": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
},
"trial_expired": false
},
"expect": {
"ip": "146.70.116.130",
"isBogon": false,
"present": {
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"trial_expired": false
},
"emptyPresent": [
"relay",
"tor",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy"
],
"vpn": {
"provider": "mullvad",
"last_seen": "2026-09-02",
"confidence": "high"
},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
}
},
{
"name": "trial-expired-answer",
"why": "A free-plan key past its trial: Unlimited's answer, and trial_expired true. What the trial no longer answers is absent, never false.",
"status": 200,
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
},
"trial_expired": true
},
"expect": {
"ip": "146.70.116.130",
"isBogon": false,
"present": {
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"trial_expired": true
},
"absent": [
"is_hosting",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"is_pubproxy",
"vpn",
"hosting",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy"
],
"emptyPresent": [
"relay",
"tor"
],
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
}
},
{
"name": "cap-reached-answer",
"why": "A paid-plan key past its organization's overage cap: Unlimited's answer, not billed, and cap_reached true. What the cap no longer answers is absent, never false.",
"status": 200,
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
},
"is_bogon": false,
"cap_reached": true
},
"expect": {
"ip": "146.70.116.130",
"isBogon": false,
"present": {
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"cap_reached": true
},
"absent": [
"is_hosting",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"is_pubproxy",
"vpn",
"hosting",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy"
],
"emptyPresent": [
"relay",
"tor"
],
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
}
},
{
"name": "unlimited-anycast-hostname",
"why": "Unlimited's answer, with a key or without one, also carries is_anycast, hostname, and the AS's country and RPKI status. The paid members stay absent, never false or empty.",
"status": 200,
"body": {
"ip": "1.1.1.1",
"is_bogon": false,
"is_vpn": false,
"is_relay": false,
"is_tor": false,
"is_anycast": true,
"relay": {},
"tor": {},
"location": {
"continent": "OC",
"continent_name": "Oceania",
"country": "AU",
"country_name": "Australia",
"timezone": "Australia/Sydney",
"currency_code": "AUD",
"currency_name": "Australian Dollar",
"currency_symbol": "$",
"flag_emoji": "🇦🇺",
"flag_unicode": "U+1F1E6 U+1F1FA"
},
"asn": {
"asn": 13335,
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"prefix": "1.1.1.0/24",
"country": "US",
"rpki_status": "valid"
},
"hostname": "one.one.one.one"
},
"expect": {
"ip": "1.1.1.1",
"isBogon": false,
"present": {
"is_vpn": false,
"is_relay": false,
"is_tor": false,
"is_anycast": true
},
"absent": [
"is_hosting",
"is_cdn",
"is_resproxy",
"is_dcproxy",
"is_mobproxy",
"is_pubproxy",
"is_carrier",
"is_satellite",
"is_ssh",
"is_smtp",
"is_web",
"is_dns_resolver",
"is_bittorrent",
"vpn",
"hosting",
"cdn",
"resproxy",
"dcproxy",
"mobproxy",
"pubproxy",
"carrier",
"satellite",
"ssh",
"smtp",
"dns_resolver",
"bittorrent",
"web",
"company",
"abuse"
],
"emptyPresent": [
"relay",
"tor"
],
"location": {
"continent": "OC",
"continent_name": "Oceania",
"country": "AU",
"country_name": "Australia",
"timezone": "Australia/Sydney",
"currency_code": "AUD",
"currency_name": "Australian Dollar",
"currency_symbol": "$",
"flag_emoji": "🇦🇺",
"flag_unicode": "U+1F1E6 U+1F1FA"
},
"asn": {
"asn": 13335,
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"prefix": "1.1.1.0/24",
"country": "US",
"rpki_status": "valid"
},
"hostname": "one.one.one.one"
}
},
{
"name": "paid-anycast-web-dns-resolver",
"why": "A paid answer carries the network and service flags with their detail, the finer location, the company, the hostname and the abuse contact. web is a row per port that answered, lowest first; a false flag's detail is {} and a false is_web's is [].",
"status": 200,
"body": {
"ip": "1.1.1.1",
"is_bogon": false,
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"is_anycast": true,
"is_carrier": false,
"is_satellite": false,
"is_ssh": false,
"is_smtp": false,
"is_web": true,
"is_dns_resolver": true,
"is_bittorrent": false,
"vpn": {},
"hosting": {},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {},
"pubproxy": {},
"carrier": {},
"satellite": {},
"ssh": {},
"smtp": {},
"web": [
{
"port": 80,
"tls_ok": false,
"session_ok": true,
"status_code": 301,
"server": "cloudflare",
"location": "https://one.one.one.one/",
"title": "",
"cert_subject_cn": "",
"cert_subject_o": "",
"cert_issuer_dn": "",
"cert_browser_trusted": false,
"tls_version": "",
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
{
"port": 443,
"tls_ok": true,
"session_ok": true,
"status_code": 200,
"server": "cloudflare",
"location": "",
"title": "1.1.1.1 | The free app that makes your Internet faster.",
"cert_subject_cn": "cloudflare-dns.com",
"cert_subject_o": "Cloudflare, Inc.",
"cert_issuer_dn": "CN=DigiCert Global G2 TLS RSA SHA256 2020 CA1,O=DigiCert Inc,C=US",
"cert_browser_trusted": true,
"tls_version": "TLS 1.3",
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
}
],
"dns_resolver": {
"port": 53,
"recursion_available": true,
"rcode": 0,
"answer_correct": true,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"bittorrent": {},
"location": {
"continent": "OC",
"continent_name": "Oceania",
"country": "AU",
"country_name": "Australia",
"timezone": "Australia/Sydney",
"currency_code": "AUD",
"currency_name": "Australian Dollar",
"currency_symbol": "$",
"flag_emoji": "🇦🇺",
"flag_unicode": "U+1F1E6 U+1F1FA",
"region": "New South Wales",
"region_code": "AU-NSW",
"city": "Sydney",
"postal_code": "2000",
"latitude": -33.86785,
"longitude": 151.20732,
"accuracy_radius": 20000,
"geoname_id": "2147714",
"dma_code": "",
"last_changed": "2026-09-30"
},
"asn": {
"asn": 13335,
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"prefix": "1.1.1.0/24",
"country": "US",
"rpki_status": "valid"
},
"company": {
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"country": "US"
},
"hostname": "one.one.one.one",
"abuse": {
"email": "abuse@cloudflare.com",
"name": "Abuse",
"phone": "+1-650-319-8930",
"address": "101 Townsend Street, San Francisco, CA 94107",
"country": "US",
"network": "1.1.1.0-1.1.1.255",
"validated": true,
"unvalidated_since": ""
},
"cap_reached": false
},
"expect": {
"ip": "1.1.1.1",
"isBogon": false,
"present": {
"is_anycast": true,
"is_carrier": false,
"is_satellite": false,
"is_ssh": false,
"is_smtp": false,
"is_web": true,
"is_dns_resolver": true,
"is_bittorrent": false,
"cap_reached": false
},
"absent": [
"trial_expired"
],
"emptyPresent": [
"carrier",
"satellite",
"ssh",
"smtp",
"bittorrent"
],
"web": [
{
"port": 80,
"tls_ok": false,
"session_ok": true,
"status_code": 301,
"server": "cloudflare",
"location": "https://one.one.one.one/",
"title": "",
"cert_subject_cn": "",
"cert_subject_o": "",
"cert_issuer_dn": "",
"cert_browser_trusted": false,
"tls_version": "",
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
{
"port": 443,
"tls_ok": true,
"session_ok": true,
"status_code": 200,
"server": "cloudflare",
"location": "",
"title": "1.1.1.1 | The free app that makes your Internet faster.",
"cert_subject_cn": "cloudflare-dns.com",
"cert_subject_o": "Cloudflare, Inc.",
"cert_issuer_dn": "CN=DigiCert Global G2 TLS RSA SHA256 2020 CA1,O=DigiCert Inc,C=US",
"cert_browser_trusted": true,
"tls_version": "TLS 1.3",
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
}
],
"dns_resolver": {
"port": 53,
"recursion_available": true,
"rcode": 0,
"answer_correct": true,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"location": {
"continent": "OC",
"continent_name": "Oceania",
"country": "AU",
"country_name": "Australia",
"timezone": "Australia/Sydney",
"currency_code": "AUD",
"currency_name": "Australian Dollar",
"currency_symbol": "$",
"flag_emoji": "🇦🇺",
"flag_unicode": "U+1F1E6 U+1F1FA",
"region": "New South Wales",
"region_code": "AU-NSW",
"city": "Sydney",
"postal_code": "2000",
"latitude": -33.86785,
"longitude": 151.20732,
"accuracy_radius": 20000,
"geoname_id": "2147714",
"dma_code": "",
"last_changed": "2026-09-30"
},
"asn": {
"asn": 13335,
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"prefix": "1.1.1.0/24",
"country": "US",
"rpki_status": "valid"
},
"company": {
"name": "Cloudflare, Inc.",
"domain": "cloudflare.com",
"type": "hosting",
"country": "US"
},
"abuse": {
"email": "abuse@cloudflare.com",
"name": "Abuse",
"phone": "+1-650-319-8930",
"address": "101 Townsend Street, San Francisco, CA 94107",
"country": "US",
"network": "1.1.1.0-1.1.1.255",
"validated": true,
"unvalidated_since": ""
},
"hostname": "one.one.one.one"
}
},
{
"name": "paid-carrier-ssh-smtp-bittorrent",
"why": "A paid answer for a carrier's address with SSH, SMTP and BitTorrent seen on it: each detail maps whole, BitTorrent's clients a list. No web server answered, so is_web is false and web is [], and an unvalidated abuse contact keeps validated false with the date it lapsed.",
"status": 200,
"body": {
"ip": "172.56.10.20",
"is_bogon": false,
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"is_anycast": false,
"is_carrier": true,
"is_satellite": false,
"is_ssh": true,
"is_smtp": true,
"is_web": false,
"is_dns_resolver": false,
"is_bittorrent": true,
"vpn": {},
"hosting": {},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {},
"pubproxy": {},
"carrier": {
"name": "T-Mobile US",
"mcc": "310",
"mnc": "260",
"country": "US",
"confidence": "high"
},
"satellite": {},
"ssh": {
"port": 22,
"banner": "SSH-2.0-OpenSSH_9.6p1 Ubuntu-3ubuntu13.5",
"host_key_fp": "SHA256:9Bq3Jrm6pVJ7QqV2c8l0pE6f8wJ4sZ4u5tYyH9cXo1E",
"session_ok": true,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"smtp": {
"port": 25,
"banner": "220 mail.example.com ESMTP Postfix",
"session_ok": false,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"web": [],
"dns_resolver": {},
"bittorrent": {
"verified": true,
"id_matches_ip": false,
"first_seen": "2026-08-21",
"last_seen": "2026-11-15",
"last_reachable": "2026-11-14",
"days_seen": 37,
"num_ports": 4,
"peak_num_ports": 2,
"indexer": false,
"clients": [
"qB",
"TR"
]
},
"location": {
"continent": "NA",
"continent_name": "North America",
"country": "US",
"country_name": "United States",
"timezone": "America/Chicago",
"currency_code": "USD",
"currency_name": "US Dollar",
"currency_symbol": "$",
"flag_emoji": "🇺🇸",
"flag_unicode": "U+1F1FA U+1F1F8",
"region": "Texas",
"region_code": "US-TX",
"city": "Dallas",
"postal_code": "75201",
"latitude": 32.78306,
"longitude": -96.80667,
"accuracy_radius": 100,
"geoname_id": "4684888",
"dma_code": "623",
"last_changed": "2026-10-12"
},
"asn": {
"asn": 21928,
"name": "T-Mobile USA, Inc.",
"domain": "t-mobile.com",
"type": "isp",
"prefix": "172.56.0.0/14",
"country": "US",
"rpki_status": "not_found"
},
"company": {
"name": "T-Mobile USA, Inc.",
"domain": "t-mobile.com",
"type": "isp",
"country": "US"
},
"hostname": "",
"abuse": {
"email": "abuse@t-mobile.com",
"name": "T-Mobile Abuse",
"phone": "",
"address": "Bellevue, WA, US",
"country": "US",
"network": "172.56.0.0-172.59.255.255",
"validated": false,
"unvalidated_since": "2025-03-01"
},
"cap_reached": false
},
"expect": {
"ip": "172.56.10.20",
"isBogon": false,
"present": {
"is_anycast": false,
"is_carrier": true,
"is_satellite": false,
"is_ssh": true,
"is_smtp": true,
"is_web": false,
"is_dns_resolver": false,
"is_bittorrent": true
},
"absent": [],
"emptyPresent": [
"satellite",
"dns_resolver"
],
"carrier": {
"name": "T-Mobile US",
"mcc": "310",
"mnc": "260",
"country": "US",
"confidence": "high"
},
"ssh": {
"port": 22,
"banner": "SSH-2.0-OpenSSH_9.6p1 Ubuntu-3ubuntu13.5",
"host_key_fp": "SHA256:9Bq3Jrm6pVJ7QqV2c8l0pE6f8wJ4sZ4u5tYyH9cXo1E",
"session_ok": true,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"smtp": {
"port": 25,
"banner": "220 mail.example.com ESMTP Postfix",
"session_ok": false,
"first_seen": "2026-08-04",
"last_seen": "2026-11-15"
},
"bittorrent": {
"verified": true,
"id_matches_ip": false,
"first_seen": "2026-08-21",
"last_seen": "2026-11-15",
"last_reachable": "2026-11-14",
"days_seen": 37,
"num_ports": 4,
"peak_num_ports": 2,
"indexer": false,
"clients": [
"qB",
"TR"
]
},
"web": [],
"location": {
"continent": "NA",
"continent_name": "North America",
"country": "US",
"country_name": "United States",
"timezone": "America/Chicago",
"currency_code": "USD",
"currency_name": "US Dollar",
"currency_symbol": "$",
"flag_emoji": "🇺🇸",
"flag_unicode": "U+1F1FA U+1F1F8",
"region": "Texas",
"region_code": "US-TX",
"city": "Dallas",
"postal_code": "75201",
"latitude": 32.78306,
"longitude": -96.80667,
"accuracy_radius": 100,
"geoname_id": "4684888",
"dma_code": "623",
"last_changed": "2026-10-12"
},
"asn": {
"asn": 21928,
"name": "T-Mobile USA, Inc.",
"domain": "t-mobile.com",
"type": "isp",
"prefix": "172.56.0.0/14",
"country": "US",
"rpki_status": "not_found"
},
"company": {
"name": "T-Mobile USA, Inc.",
"domain": "t-mobile.com",
"type": "isp",
"country": "US"
},
"abuse": {
"email": "abuse@t-mobile.com",
"name": "T-Mobile Abuse",
"phone": "",
"address": "Bellevue, WA, US",
"country": "US",
"network": "172.56.0.0-172.59.255.255",
"validated": false,
"unvalidated_since": "2025-03-01"
},
"hostname": ""
}
},
{
"name": "paid-satellite",
"why": "A paid answer for a satellite operator's address: satellite maps whole, its asn an integer, and every other new detail is empty.",
"status": 200,
"body": {
"ip": "98.97.0.1",
"is_bogon": false,
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"is_pubproxy": false,
"is_anycast": false,
"is_carrier": false,
"is_satellite": true,
"is_ssh": false,
"is_smtp": false,
"is_web": false,
"is_dns_resolver": false,
"is_bittorrent": false,
"vpn": {},
"hosting": {},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {},
"pubproxy": {},
"carrier": {},
"satellite": {
"provider": "starlink",
"provider_name": "Starlink",
"orbit": "leo",
"segment": "consumer",
"country": "US",
"asn": 14593,
"confidence": "high"
},
"ssh": {},
"smtp": {},
"web": [],
"dns_resolver": {},
"bittorrent": {},
"location": {
"continent": "NA",
"continent_name": "North America",
"country": "US",
"country_name": "United States",
"timezone": "America/Los_Angeles",
"currency_code": "USD",
"currency_name": "US Dollar",
"currency_symbol": "$",
"flag_emoji": "🇺🇸",
"flag_unicode": "U+1F1FA U+1F1F8",
"region": "California",
"region_code": "US-CA",
"city": "Los Angeles",
"postal_code": "90001",
"latitude": 34.05223,
"longitude": -118.24368,
"accuracy_radius": 500,
"geoname_id": "5368361",
"dma_code": "803",
"last_changed": "2026-10-20"
},
"asn": {
"asn": 14593,
"name": "Space Exploration Technologies Corporation",
"domain": "spacex.com",
"type": "isp",
"prefix": "98.97.0.0/20",
"country": "US",
"rpki_status": "valid"
},
"company": {
"name": "Starlink",
"domain": "starlink.com",
"type": "isp",
"country": "US"
},
"hostname": "customer.lsancax1.isp.starlinkisp.net",
"abuse": {
"email": "abuse@spacex.com",
"name": "SpaceX Abuse",
"phone": "",
"address": "Hawthorne, CA, US",
"country": "US",
"network": "98.97.0.0-98.97.15.255",
"validated": true,
"unvalidated_since": ""
},
"cap_reached": false
},
"expect": {
"ip": "98.97.0.1",
"isBogon": false,
"present": {
"is_satellite": true,
"is_carrier": false,
"is_web": false
},
"absent": [],
"emptyPresent": [
"carrier",
"ssh",
"smtp",
"dns_resolver",
"bittorrent"
],
"satellite": {
"provider": "starlink",
"provider_name": "Starlink",
"orbit": "leo",
"segment": "consumer",
"country": "US",
"asn": 14593,
"confidence": "high"
},
"web": [],
"location": {
"continent": "NA",
"continent_name": "North America",
"country": "US",
"country_name": "United States",
"timezone": "America/Los_Angeles",
"currency_code": "USD",
"currency_name": "US Dollar",
"currency_symbol": "$",
"flag_emoji": "🇺🇸",
"flag_unicode": "U+1F1FA U+1F1F8",
"region": "California",
"region_code": "US-CA",
"city": "Los Angeles",
"postal_code": "90001",
"latitude": 34.05223,
"longitude": -118.24368,
"accuracy_radius": 500,
"geoname_id": "5368361",
"dma_code": "803",
"last_changed": "2026-10-20"
},
"asn": {
"asn": 14593,
"name": "Space Exploration Technologies Corporation",
"domain": "spacex.com",
"type": "isp",
"prefix": "98.97.0.0/20",
"country": "US",
"rpki_status": "valid"
},
"company": {
"name": "Starlink",
"domain": "starlink.com",
"type": "isp",
"country": "US"
},
"abuse": {
"email": "abuse@spacex.com",
"name": "SpaceX Abuse",
"phone": "",
"address": "Hawthorne, CA, US",
"country": "US",
"network": "98.97.0.0-98.97.15.255",
"validated": true,
"unvalidated_since": ""
},
"hostname": "customer.lsancax1.isp.starlinkisp.net"
}
}
],
"errors": [
{
"name": "invalid-ip",
"status": 400,
"headers": {},
"body": {
"error": "not a valid IP address"
},
"expect": {
"kind": "bad_request",
"retryable": false,
"message": "not a valid IP address"
}
},
{
"name": "invalid-key",
"status": 401,
"headers": {},
"body": {
"error": "invalid API key"
},
"expect": {
"kind": "unauthorized",
"retryable": false,
"message": "invalid API key"
}
},
{
"name": "cidr-restricted",
"status": 403,
"headers": {},
"body": {
"error": "source address not allowed for this API key"
},
"expect": {
"kind": "forbidden",
"retryable": false
}
},
{
"name": "not-found-is-not-retryable",
"why": "A 404 is a CLIENT error. Falling through to the server_error default makes it retryable, so a bad dataset id is retried before it fails. Only 5xx and transport failures are retryable.",
"status": 404,
"headers": {},
"body": {
"rc": "NOT_FOUND"
},
"expect": {
"kind": "bad_request",
"retryable": false
}
},
{
"name": "unlisted-4xx-is-not-retryable",
"why": "The RANGE is the rule, not a list of statuses. An SDK that enumerated 400 and 404 passed every other case here while a 422 fell through to the retryable server_error default.",
"status": 422,
"headers": {},
"body": {
"rc": "INVALID_REQUEST"
},
"expect": {
"kind": "bad_request",
"retryable": false
}
},
{
"name": "rate-limited-is-retryable",
"why": "Retry-After present. This is the API protecting itself and retrying WILL succeed.",
"status": 429,
"headers": {
"Retry-After": "1"
},
"body": {
"error": "rate limit exceeded"
},
"expect": {
"kind": "rate_limited",
"retryable": true,
"retryAfterSeconds": 1
}
},
{
"name": "unlimited-rate-limit-is-retryable",
"why": "Retry-After present. A lookup on Unlimited, the free plan, with a key or without one, that the API is protecting itself from is told when to come back, which is a rate limit, so retrying after the wait WILL succeed.",
"status": 429,
"headers": {
"Retry-After": "1"
},
"body": {
"error": "rate limit for Unlimited lookups exceeded; retry shortly, or use a paid plan"
},
"expect": {
"kind": "rate_limited",
"retryable": true,
"retryAfterSeconds": 1
}
},
{
"name": "batch-needs-a-paid-plan-is-a-bad-request",
"why": "A free-plan key's batch of more than one address answers 402. To a client it is any other 4xx: refused as asked, never retried, its message the API's.",
"status": 402,
"headers": {},
"body": {
"error": "POST /batch needs a paid plan"
},
"expect": {
"kind": "bad_request",
"retryable": false,
"message": "POST /batch needs a paid plan"
}
},
{
"name": "overage-cap-is-not-retryable",
"why": "No Retry-After. A paid key has reached its overage cap, and raising the cap in Billing, not retrying, is what helps.",
"status": 429,
"headers": {},
"body": {
"error": "overage cap reached; raise or remove it in Billing"
},
"expect": {
"kind": "quota_exceeded",
"retryable": false
}
},
{
"name": "server-error-is-retryable",
"status": 500,
"headers": {},
"body": {
"error": "lookup failed"
},
"expect": {
"kind": "server_error",
"retryable": true
}
}
],
"batch": [
{
"name": "dedup-bogon-and-order-free-keying",
"why": "Duplicates collapse to one entry, bogons never reach the network, and what is left goes to POST /batch in ONE request rather than one request per address. The result is keyed by IP so input order stops mattering.",
"input": [
"1.1.1.1",
"8.8.8.8",
"1.1.1.1",
"10.0.0.1",
"192.168.1.1"
],
"expect": {
"keys": [
"1.1.1.1",
"8.8.8.8",
"10.0.0.1",
"192.168.1.1"
],
"httpRequests": 1,
"bogonKeys": [
"10.0.0.1",
"192.168.1.1"
]
}
},
{
"name": "partial-failure-does-not-fail-the-batch",
"why": "One address erroring must leave the others answered; the failure is carried in that key's value. The server reports it per entry as {status, error}, and the entry is classified by that status exactly as a single lookup answering it would be.",
"input": [
"1.1.1.1",
"notanip"
],
"expect": {
"keys": [
"1.1.1.1",
"notanip"
],
"errorKeys": [
"notanip"
],
"errorKinds": {
"notanip": "bad_request"
}
}
},
{
"name": "cache-hit-issues-no-second-request",
"why": "The second batch over the same address is served entirely from the per-client cache.",
"input": [
"1.1.1.1"
],
"repeat": 2,
"expect": {
"keys": [
"1.1.1.1"
],
"httpRequests": 1
}
},
{
"name": "chunks-of-one-thousand",
"why": "POST /batch takes at most 1000 addresses per call, so a larger input is sent in chunks of 1000 and every address is still answered exactly once.",
"input": [
"9.0.0.1",
"9.0.0.2",
"9.0.0.3",
"9.0.0.4",
"9.0.0.5",
"9.0.0.6",
"9.0.0.7",
"9.0.0.8",
"9.0.0.9",
"9.0.0.10",
"9.0.0.11",
"9.0.0.12",
"9.0.0.13",
"9.0.0.14",
"9.0.0.15",
"9.0.0.16",
"9.0.0.17",
"9.0.0.18",
"9.0.0.19",
"9.0.0.20",
"9.0.0.21",
"9.0.0.22",
"9.0.0.23",
"9.0.0.24",
"9.0.0.25",
"9.0.0.26",
"9.0.0.27",
"9.0.0.28",
"9.0.0.29",
"9.0.0.30",
"9.0.0.31",
"9.0.0.32",
"9.0.0.33",
"9.0.0.34",
"9.0.0.35",
"9.0.0.36",
"9.0.0.37",
"9.0.0.38",
"9.0.0.39",
"9.0.0.40",
"9.0.0.41",
"9.0.0.42",
"9.0.0.43",
"9.0.0.44",
"9.0.0.45",
"9.0.0.46",
"9.0.0.47",
"9.0.0.48",
"9.0.0.49",
"9.0.0.50",
"9.0.0.51",
"9.0.0.52",
"9.0.0.53",
"9.0.0.54",
"9.0.0.55",
"9.0.0.56",
"9.0.0.57",
"9.0.0.58",
"9.0.0.59",
"9.0.0.60",
"9.0.0.61",
"9.0.0.62",
"9.0.0.63",
"9.0.0.64",
"9.0.0.65",
"9.0.0.66",
"9.0.0.67",
"9.0.0.68",
"9.0.0.69",
"9.0.0.70",
"9.0.0.71",
"9.0.0.72",
"9.0.0.73",
"9.0.0.74",
"9.0.0.75",
"9.0.0.76",
"9.0.0.77",
"9.0.0.78",
"9.0.0.79",
"9.0.0.80",
"9.0.0.81",
"9.0.0.82",
"9.0.0.83",
"9.0.0.84",
"9.0.0.85",
"9.0.0.86",
"9.0.0.87",
"9.0.0.88",
"9.0.0.89",
"9.0.0.90",
"9.0.0.91",
"9.0.0.92",
"9.0.0.93",
"9.0.0.94",
"9.0.0.95",
"9.0.0.96",
"9.0.0.97",
"9.0.0.98",
"9.0.0.99",
"9.0.0.100",
"9.0.0.101",
"9.0.0.102",
"9.0.0.103",
"9.0.0.104",
"9.0.0.105",
"9.0.0.106",
"9.0.0.107",
"9.0.0.108",
"9.0.0.109",
"9.0.0.110",
"9.0.0.111",
"9.0.0.112",
"9.0.0.113",
"9.0.0.114",
"9.0.0.115",
"9.0.0.116",
"9.0.0.117",
"9.0.0.118",
"9.0.0.119",
"9.0.0.120",
"9.0.0.121",
"9.0.0.122",
"9.0.0.123",
"9.0.0.124",
"9.0.0.125",
"9.0.0.126",
"9.0.0.127",
"9.0.0.128",
"9.0.0.129",
"9.0.0.130",
"9.0.0.131",
"9.0.0.132",
"9.0.0.133",
"9.0.0.134",
"9.0.0.135",
"9.0.0.136",
"9.0.0.137",
"9.0.0.138",
"9.0.0.139",
"9.0.0.140",
"9.0.0.141",
"9.0.0.142",
"9.0.0.143",
"9.0.0.144",
"9.0.0.145",
"9.0.0.146",
"9.0.0.147",
"9.0.0.148",
"9.0.0.149",
"9.0.0.150",
"9.0.0.151",
"9.0.0.152",
"9.0.0.153",
"9.0.0.154",
"9.0.0.155",
"9.0.0.156",
"9.0.0.157",
"9.0.0.158",
"9.0.0.159",
"9.0.0.160",
"9.0.0.161",
"9.0.0.162",
"9.0.0.163",
"9.0.0.164",
"9.0.0.165",
"9.0.0.166",
"9.0.0.167",
"9.0.0.168",
"9.0.0.169",
"9.0.0.170",
"9.0.0.171",
"9.0.0.172",
"9.0.0.173",
"9.0.0.174",
"9.0.0.175",
"9.0.0.176",
"9.0.0.177",
"9.0.0.178",
"9.0.0.179",
"9.0.0.180",
"9.0.0.181",
"9.0.0.182",
"9.0.0.183",
"9.0.0.184",
"9.0.0.185",
"9.0.0.186",
"9.0.0.187",
"9.0.0.188",
"9.0.0.189",
"9.0.0.190",
"9.0.0.191",
"9.0.0.192",
"9.0.0.193",
"9.0.0.194",
"9.0.0.195",
"9.0.0.196",
"9.0.0.197",
"9.0.0.198",
"9.0.0.199",
"9.0.0.200",
"9.0.0.201",
"9.0.0.202",
"9.0.0.203",
"9.0.0.204",
"9.0.0.205",
"9.0.0.206",
"9.0.0.207",
"9.0.0.208",
"9.0.0.209",
"9.0.0.210",
"9.0.0.211",
"9.0.0.212",
"9.0.0.213",
"9.0.0.214",
"9.0.0.215",
"9.0.0.216",
"9.0.0.217",
"9.0.0.218",
"9.0.0.219",
"9.0.0.220",
"9.0.0.221",
"9.0.0.222",
"9.0.0.223",
"9.0.0.224",
"9.0.0.225",
"9.0.0.226",
"9.0.0.227",
"9.0.0.228",
"9.0.0.229",
"9.0.0.230",
"9.0.0.231",
"9.0.0.232",
"9.0.0.233",
"9.0.0.234",
"9.0.0.235",
"9.0.0.236",
"9.0.0.237",
"9.0.0.238",
"9.0.0.239",
"9.0.0.240",
"9.0.0.241",
"9.0.0.242",
"9.0.0.243",
"9.0.0.244",
"9.0.0.245",
"9.0.0.246",
"9.0.0.247",
"9.0.0.248",
"9.0.0.249",
"9.0.0.250",
"9.0.0.251",
"9.0.0.252",
"9.0.0.253",
"9.0.0.254",
"9.0.0.255",
"9.0.1.0",
"9.0.1.1",
"9.0.1.2",
"9.0.1.3",
"9.0.1.4",
"9.0.1.5",
"9.0.1.6",
"9.0.1.7",
"9.0.1.8",
"9.0.1.9",
"9.0.1.10",
"9.0.1.11",
"9.0.1.12",
"9.0.1.13",
"9.0.1.14",
"9.0.1.15",
"9.0.1.16",
"9.0.1.17",
"9.0.1.18",
"9.0.1.19",
"9.0.1.20",
"9.0.1.21",
"9.0.1.22",
"9.0.1.23",
"9.0.1.24",
"9.0.1.25",
"9.0.1.26",
"9.0.1.27",
"9.0.1.28",
"9.0.1.29",
"9.0.1.30",
"9.0.1.31",
"9.0.1.32",
"9.0.1.33",
"9.0.1.34",
"9.0.1.35",
"9.0.1.36",
"9.0.1.37",
"9.0.1.38",
"9.0.1.39",
"9.0.1.40",
"9.0.1.41",
"9.0.1.42",
"9.0.1.43",
"9.0.1.44",
"9.0.1.45",
"9.0.1.46",
"9.0.1.47",
"9.0.1.48",
"9.0.1.49",
"9.0.1.50",
"9.0.1.51",
"9.0.1.52",
"9.0.1.53",
"9.0.1.54",
"9.0.1.55",
"9.0.1.56",
"9.0.1.57",
"9.0.1.58",
"9.0.1.59",
"9.0.1.60",
"9.0.1.61",
"9.0.1.62",
"9.0.1.63",
"9.0.1.64",
"9.0.1.65",
"9.0.1.66",
"9.0.1.67",
"9.0.1.68",
"9.0.1.69",
"9.0.1.70",
"9.0.1.71",
"9.0.1.72",
"9.0.1.73",
"9.0.1.74",
"9.0.1.75",
"9.0.1.76",
"9.0.1.77",
"9.0.1.78",
"9.0.1.79",
"9.0.1.80",
"9.0.1.81",
"9.0.1.82",
"9.0.1.83",
"9.0.1.84",
"9.0.1.85",
"9.0.1.86",
"9.0.1.87",
"9.0.1.88",
"9.0.1.89",
"9.0.1.90",
"9.0.1.91",
"9.0.1.92",
"9.0.1.93",
"9.0.1.94",
"9.0.1.95",
"9.0.1.96",
"9.0.1.97",
"9.0.1.98",
"9.0.1.99",
"9.0.1.100",
"9.0.1.101",
"9.0.1.102",
"9.0.1.103",
"9.0.1.104",
"9.0.1.105",
"9.0.1.106",
"9.0.1.107",
"9.0.1.108",
"9.0.1.109",
"9.0.1.110",
"9.0.1.111",
"9.0.1.112",
"9.0.1.113",
"9.0.1.114",
"9.0.1.115",
"9.0.1.116",
"9.0.1.117",
"9.0.1.118",
"9.0.1.119",
"9.0.1.120",
"9.0.1.121",
"9.0.1.122",
"9.0.1.123",
"9.0.1.124",
"9.0.1.125",
"9.0.1.126",
"9.0.1.127",
"9.0.1.128",
"9.0.1.129",
"9.0.1.130",
"9.0.1.131",
"9.0.1.132",
"9.0.1.133",
"9.0.1.134",
"9.0.1.135",
"9.0.1.136",
"9.0.1.137",
"9.0.1.138",
"9.0.1.139",
"9.0.1.140",
"9.0.1.141",
"9.0.1.142",
"9.0.1.143",
"9.0.1.144",
"9.0.1.145",
"9.0.1.146",
"9.0.1.147",
"9.0.1.148",
"9.0.1.149",
"9.0.1.150",
"9.0.1.151",
"9.0.1.152",
"9.0.1.153",
"9.0.1.154",
"9.0.1.155",
"9.0.1.156",
"9.0.1.157",
"9.0.1.158",
"9.0.1.159",
"9.0.1.160",
"9.0.1.161",
"9.0.1.162",
"9.0.1.163",
"9.0.1.164",
"9.0.1.165",
"9.0.1.166",
"9.0.1.167",
"9.0.1.168",
"9.0.1.169",
"9.0.1.170",
"9.0.1.171",
"9.0.1.172",
"9.0.1.173",
"9.0.1.174",
"9.0.1.175",
"9.0.1.176",
"9.0.1.177",
"9.0.1.178",
"9.0.1.179",
"9.0.1.180",
"9.0.1.181",
"9.0.1.182",
"9.0.1.183",
"9.0.1.184",
"9.0.1.185",
"9.0.1.186",
"9.0.1.187",
"9.0.1.188",
"9.0.1.189",
"9.0.1.190",
"9.0.1.191",
"9.0.1.192",
"9.0.1.193",
"9.0.1.194",
"9.0.1.195",
"9.0.1.196",
"9.0.1.197",
"9.0.1.198",
"9.0.1.199",
"9.0.1.200",
"9.0.1.201",
"9.0.1.202",
"9.0.1.203",
"9.0.1.204",
"9.0.1.205",
"9.0.1.206",
"9.0.1.207",
"9.0.1.208",
"9.0.1.209",
"9.0.1.210",
"9.0.1.211",
"9.0.1.212",
"9.0.1.213",
"9.0.1.214",
"9.0.1.215",
"9.0.1.216",
"9.0.1.217",
"9.0.1.218",
"9.0.1.219",
"9.0.1.220",
"9.0.1.221",
"9.0.1.222",
"9.0.1.223",
"9.0.1.224",
"9.0.1.225",
"9.0.1.226",
"9.0.1.227",
"9.0.1.228",
"9.0.1.229",
"9.0.1.230",
"9.0.1.231",
"9.0.1.232",
"9.0.1.233",
"9.0.1.234",
"9.0.1.235",
"9.0.1.236",
"9.0.1.237",
"9.0.1.238",
"9.0.1.239",
"9.0.1.240",
"9.0.1.241",
"9.0.1.242",
"9.0.1.243",
"9.0.1.244",
"9.0.1.245",
"9.0.1.246",
"9.0.1.247",
"9.0.1.248",
"9.0.1.249",
"9.0.1.250",
"9.0.1.251",
"9.0.1.252",
"9.0.1.253",
"9.0.1.254",
"9.0.1.255",
"9.0.2.0",
"9.0.2.1",
"9.0.2.2",
"9.0.2.3",
"9.0.2.4",
"9.0.2.5",
"9.0.2.6",
"9.0.2.7",
"9.0.2.8",
"9.0.2.9",
"9.0.2.10",
"9.0.2.11",
"9.0.2.12",
"9.0.2.13",
"9.0.2.14",
"9.0.2.15",
"9.0.2.16",
"9.0.2.17",
"9.0.2.18",
"9.0.2.19",
"9.0.2.20",
"9.0.2.21",
"9.0.2.22",
"9.0.2.23",
"9.0.2.24",
"9.0.2.25",
"9.0.2.26",
"9.0.2.27",
"9.0.2.28",
"9.0.2.29",
"9.0.2.30",
"9.0.2.31",
"9.0.2.32",
"9.0.2.33",
"9.0.2.34",
"9.0.2.35",
"9.0.2.36",
"9.0.2.37",
"9.0.2.38",
"9.0.2.39",
"9.0.2.40",
"9.0.2.41",
"9.0.2.42",
"9.0.2.43",
"9.0.2.44",
"9.0.2.45",
"9.0.2.46",
"9.0.2.47",
"9.0.2.48",
"9.0.2.49",
"9.0.2.50",
"9.0.2.51",
"9.0.2.52",
"9.0.2.53",
"9.0.2.54",
"9.0.2.55",
"9.0.2.56",
"9.0.2.57",
"9.0.2.58",
"9.0.2.59",
"9.0.2.60",
"9.0.2.61",
"9.0.2.62",
"9.0.2.63",
"9.0.2.64",
"9.0.2.65",
"9.0.2.66",
"9.0.2.67",
"9.0.2.68",
"9.0.2.69",
"9.0.2.70",
"9.0.2.71",
"9.0.2.72",
"9.0.2.73",
"9.0.2.74",
"9.0.2.75",
"9.0.2.76",
"9.0.2.77",
"9.0.2.78",
"9.0.2.79",
"9.0.2.80",
"9.0.2.81",
"9.0.2.82",
"9.0.2.83",
"9.0.2.84",
"9.0.2.85",
"9.0.2.86",
"9.0.2.87",
"9.0.2.88",
"9.0.2.89",
"9.0.2.90",
"9.0.2.91",
"9.0.2.92",
"9.0.2.93",
"9.0.2.94",
"9.0.2.95",
"9.0.2.96",
"9.0.2.97",
"9.0.2.98",
"9.0.2.99",
"9.0.2.100",
"9.0.2.101",
"9.0.2.102",
"9.0.2.103",
"9.0.2.104",
"9.0.2.105",
"9.0.2.106",
"9.0.2.107",
"9.0.2.108",
"9.0.2.109",
"9.0.2.110",
"9.0.2.111",
"9.0.2.112",
"9.0.2.113",
"9.0.2.114",
"9.0.2.115",
"9.0.2.116",
"9.0.2.117",
"9.0.2.118",
"9.0.2.119",
"9.0.2.120",
"9.0.2.121",
"9.0.2.122",
"9.0.2.123",
"9.0.2.124",
"9.0.2.125",
"9.0.2.126",
"9.0.2.127",
"9.0.2.128",
"9.0.2.129",
"9.0.2.130",
"9.0.2.131",
"9.0.2.132",
"9.0.2.133",
"9.0.2.134",
"9.0.2.135",
"9.0.2.136",
"9.0.2.137",
"9.0.2.138",
"9.0.2.139",
"9.0.2.140",
"9.0.2.141",
"9.0.2.142",
"9.0.2.143",
"9.0.2.144",
"9.0.2.145",
"9.0.2.146",
"9.0.2.147",
"9.0.2.148",
"9.0.2.149",
"9.0.2.150",
"9.0.2.151",
"9.0.2.152",
"9.0.2.153",
"9.0.2.154",
"9.0.2.155",
"9.0.2.156",
"9.0.2.157",
"9.0.2.158",
"9.0.2.159",
"9.0.2.160",
"9.0.2.161",
"9.0.2.162",
"9.0.2.163",
"9.0.2.164",
"9.0.2.165",
"9.0.2.166",
"9.0.2.167",
"9.0.2.168",
"9.0.2.169",
"9.0.2.170",
"9.0.2.171",
"9.0.2.172",
"9.0.2.173",
"9.0.2.174",
"9.0.2.175",
"9.0.2.176",
"9.0.2.177",
"9.0.2.178",
"9.0.2.179",
"9.0.2.180",
"9.0.2.181",
"9.0.2.182",
"9.0.2.183",
"9.0.2.184",
"9.0.2.185",
"9.0.2.186",
"9.0.2.187",
"9.0.2.188",
"9.0.2.189",
"9.0.2.190",
"9.0.2.191",
"9.0.2.192",
"9.0.2.193",
"9.0.2.194",
"9.0.2.195",
"9.0.2.196",
"9.0.2.197",
"9.0.2.198",
"9.0.2.199",
"9.0.2.200",
"9.0.2.201",
"9.0.2.202",
"9.0.2.203",
"9.0.2.204",
"9.0.2.205",
"9.0.2.206",
"9.0.2.207",
"9.0.2.208",
"9.0.2.209",
"9.0.2.210",
"9.0.2.211",
"9.0.2.212",
"9.0.2.213",
"9.0.2.214",
"9.0.2.215",
"9.0.2.216",
"9.0.2.217",
"9.0.2.218",
"9.0.2.219",
"9.0.2.220",
"9.0.2.221",
"9.0.2.222",
"9.0.2.223",
"9.0.2.224",
"9.0.2.225",
"9.0.2.226",
"9.0.2.227",
"9.0.2.228",
"9.0.2.229",
"9.0.2.230",
"9.0.2.231",
"9.0.2.232",
"9.0.2.233",
"9.0.2.234",
"9.0.2.235",
"9.0.2.236",
"9.0.2.237",
"9.0.2.238",
"9.0.2.239",
"9.0.2.240",
"9.0.2.241",
"9.0.2.242",
"9.0.2.243",
"9.0.2.244",
"9.0.2.245",
"9.0.2.246",
"9.0.2.247",
"9.0.2.248",
"9.0.2.249",
"9.0.2.250",
"9.0.2.251",
"9.0.2.252",
"9.0.2.253",
"9.0.2.254",
"9.0.2.255",
"9.0.3.0",
"9.0.3.1",
"9.0.3.2",
"9.0.3.3",
"9.0.3.4",
"9.0.3.5",
"9.0.3.6",
"9.0.3.7",
"9.0.3.8",
"9.0.3.9",
"9.0.3.10",
"9.0.3.11",
"9.0.3.12",
"9.0.3.13",
"9.0.3.14",
"9.0.3.15",
"9.0.3.16",
"9.0.3.17",
"9.0.3.18",
"9.0.3.19",
"9.0.3.20",
"9.0.3.21",
"9.0.3.22",
"9.0.3.23",
"9.0.3.24",
"9.0.3.25",
"9.0.3.26",
"9.0.3.27",
"9.0.3.28",
"9.0.3.29",
"9.0.3.30",
"9.0.3.31",
"9.0.3.32",
"9.0.3.33",
"9.0.3.34",
"9.0.3.35",
"9.0.3.36",
"9.0.3.37",
"9.0.3.38",
"9.0.3.39",
"9.0.3.40",
"9.0.3.41",
"9.0.3.42",
"9.0.3.43",
"9.0.3.44",
"9.0.3.45",
"9.0.3.46",
"9.0.3.47",
"9.0.3.48",
"9.0.3.49",
"9.0.3.50",
"9.0.3.51",
"9.0.3.52",
"9.0.3.53",
"9.0.3.54",
"9.0.3.55",
"9.0.3.56",
"9.0.3.57",
"9.0.3.58",
"9.0.3.59",
"9.0.3.60",
"9.0.3.61",
"9.0.3.62",
"9.0.3.63",
"9.0.3.64",
"9.0.3.65",
"9.0.3.66",
"9.0.3.67",
"9.0.3.68",
"9.0.3.69",
"9.0.3.70",
"9.0.3.71",
"9.0.3.72",
"9.0.3.73",
"9.0.3.74",
"9.0.3.75",
"9.0.3.76",
"9.0.3.77",
"9.0.3.78",
"9.0.3.79",
"9.0.3.80",
"9.0.3.81",
"9.0.3.82",
"9.0.3.83",
"9.0.3.84",
"9.0.3.85",
"9.0.3.86",
"9.0.3.87",
"9.0.3.88",
"9.0.3.89",
"9.0.3.90",
"9.0.3.91",
"9.0.3.92",
"9.0.3.93",
"9.0.3.94",
"9.0.3.95",
"9.0.3.96",
"9.0.3.97",
"9.0.3.98",
"9.0.3.99",
"9.0.3.100",
"9.0.3.101",
"9.0.3.102",
"9.0.3.103",
"9.0.3.104",
"9.0.3.105",
"9.0.3.106",
"9.0.3.107",
"9.0.3.108",
"9.0.3.109",
"9.0.3.110",
"9.0.3.111",
"9.0.3.112",
"9.0.3.113",
"9.0.3.114",
"9.0.3.115",
"9.0.3.116",
"9.0.3.117",
"9.0.3.118",
"9.0.3.119",
"9.0.3.120",
"9.0.3.121",
"9.0.3.122",
"9.0.3.123",
"9.0.3.124",
"9.0.3.125",
"9.0.3.126",
"9.0.3.127",
"9.0.3.128",
"9.0.3.129",
"9.0.3.130",
"9.0.3.131",
"9.0.3.132",
"9.0.3.133",
"9.0.3.134",
"9.0.3.135",
"9.0.3.136",
"9.0.3.137",
"9.0.3.138",
"9.0.3.139",
"9.0.3.140",
"9.0.3.141",
"9.0.3.142",
"9.0.3.143",
"9.0.3.144",
"9.0.3.145",
"9.0.3.146",
"9.0.3.147",
"9.0.3.148",
"9.0.3.149",
"9.0.3.150",
"9.0.3.151",
"9.0.3.152",
"9.0.3.153",
"9.0.3.154",
"9.0.3.155",
"9.0.3.156",
"9.0.3.157",
"9.0.3.158",
"9.0.3.159",
"9.0.3.160",
"9.0.3.161",
"9.0.3.162",
"9.0.3.163",
"9.0.3.164",
"9.0.3.165",
"9.0.3.166",
"9.0.3.167",
"9.0.3.168",
"9.0.3.169",
"9.0.3.170",
"9.0.3.171",
"9.0.3.172",
"9.0.3.173",
"9.0.3.174",
"9.0.3.175",
"9.0.3.176",
"9.0.3.177",
"9.0.3.178",
"9.0.3.179",
"9.0.3.180",
"9.0.3.181",
"9.0.3.182",
"9.0.3.183",
"9.0.3.184",
"9.0.3.185",
"9.0.3.186",
"9.0.3.187",
"9.0.3.188",
"9.0.3.189",
"9.0.3.190",
"9.0.3.191",
"9.0.3.192",
"9.0.3.193",
"9.0.3.194",
"9.0.3.195",
"9.0.3.196",
"9.0.3.197",
"9.0.3.198",
"9.0.3.199",
"9.0.3.200",
"9.0.3.201",
"9.0.3.202",
"9.0.3.203",
"9.0.3.204",
"9.0.3.205",
"9.0.3.206",
"9.0.3.207",
"9.0.3.208",
"9.0.3.209",
"9.0.3.210",
"9.0.3.211",
"9.0.3.212",
"9.0.3.213",
"9.0.3.214",
"9.0.3.215",
"9.0.3.216",
"9.0.3.217",
"9.0.3.218",
"9.0.3.219",
"9.0.3.220",
"9.0.3.221",
"9.0.3.222",
"9.0.3.223",
"9.0.3.224",
"9.0.3.225",
"9.0.3.226",
"9.0.3.227",
"9.0.3.228",
"9.0.3.229",
"9.0.3.230",
"9.0.3.231",
"9.0.3.232",
"9.0.3.233"
],
"expect": {
"keyCount": 1001,
"httpRequests": 2
}
},
{
"name": "uncapped-input-is-chunked",
"why": "A call takes any number of addresses (contract.md, decided 2026-09-16): 2,500 is three POST /batch requests of at most 1000, never a refusal, and every address is answered exactly once. chunks-of-one-thousand pins the boundary; this pins the absence of a cap.",
"input": [
"9.0.0.1",
"9.0.0.2",
"9.0.0.3",
"9.0.0.4",
"9.0.0.5",
"9.0.0.6",
"9.0.0.7",
"9.0.0.8",
"9.0.0.9",
"9.0.0.10",
"9.0.0.11",
"9.0.0.12",
"9.0.0.13",
"9.0.0.14",
"9.0.0.15",
"9.0.0.16",
"9.0.0.17",
"9.0.0.18",
"9.0.0.19",
"9.0.0.20",
"9.0.0.21",
"9.0.0.22",
"9.0.0.23",
"9.0.0.24",
"9.0.0.25",
"9.0.0.26",
"9.0.0.27",
"9.0.0.28",
"9.0.0.29",
"9.0.0.30",
"9.0.0.31",
"9.0.0.32",
"9.0.0.33",
"9.0.0.34",
"9.0.0.35",
"9.0.0.36",
"9.0.0.37",
"9.0.0.38",
"9.0.0.39",
"9.0.0.40",
"9.0.0.41",
"9.0.0.42",
"9.0.0.43",
"9.0.0.44",
"9.0.0.45",
"9.0.0.46",
"9.0.0.47",
"9.0.0.48",
"9.0.0.49",
"9.0.0.50",
"9.0.0.51",
"9.0.0.52",
"9.0.0.53",
"9.0.0.54",
"9.0.0.55",
"9.0.0.56",
"9.0.0.57",
"9.0.0.58",
"9.0.0.59",
"9.0.0.60",
"9.0.0.61",
"9.0.0.62",
"9.0.0.63",
"9.0.0.64",
"9.0.0.65",
"9.0.0.66",
"9.0.0.67",
"9.0.0.68",
"9.0.0.69",
"9.0.0.70",
"9.0.0.71",
"9.0.0.72",
"9.0.0.73",
"9.0.0.74",
"9.0.0.75",
"9.0.0.76",
"9.0.0.77",
"9.0.0.78",
"9.0.0.79",
"9.0.0.80",
"9.0.0.81",
"9.0.0.82",
"9.0.0.83",
"9.0.0.84",
"9.0.0.85",
"9.0.0.86",
"9.0.0.87",
"9.0.0.88",
"9.0.0.89",
"9.0.0.90",
"9.0.0.91",
"9.0.0.92",
"9.0.0.93",
"9.0.0.94",
"9.0.0.95",
"9.0.0.96",
"9.0.0.97",
"9.0.0.98",
"9.0.0.99",
"9.0.0.100",
"9.0.0.101",
"9.0.0.102",
"9.0.0.103",
"9.0.0.104",
"9.0.0.105",
"9.0.0.106",
"9.0.0.107",
"9.0.0.108",
"9.0.0.109",
"9.0.0.110",
"9.0.0.111",
"9.0.0.112",
"9.0.0.113",
"9.0.0.114",
"9.0.0.115",
"9.0.0.116",
"9.0.0.117",
"9.0.0.118",
"9.0.0.119",
"9.0.0.120",
"9.0.0.121",
"9.0.0.122",
"9.0.0.123",
"9.0.0.124",
"9.0.0.125",
"9.0.0.126",
"9.0.0.127",
"9.0.0.128",
"9.0.0.129",
"9.0.0.130",
"9.0.0.131",
"9.0.0.132",
"9.0.0.133",
"9.0.0.134",
"9.0.0.135",
"9.0.0.136",
"9.0.0.137",
"9.0.0.138",
"9.0.0.139",
"9.0.0.140",
"9.0.0.141",
"9.0.0.142",
"9.0.0.143",
"9.0.0.144",
"9.0.0.145",
"9.0.0.146",
"9.0.0.147",
"9.0.0.148",
"9.0.0.149",
"9.0.0.150",
"9.0.0.151",
"9.0.0.152",
"9.0.0.153",
"9.0.0.154",
"9.0.0.155",
"9.0.0.156",
"9.0.0.157",
"9.0.0.158",
"9.0.0.159",
"9.0.0.160",
"9.0.0.161",
"9.0.0.162",
"9.0.0.163",
"9.0.0.164",
"9.0.0.165",
"9.0.0.166",
"9.0.0.167",
"9.0.0.168",
"9.0.0.169",
"9.0.0.170",
"9.0.0.171",
"9.0.0.172",
"9.0.0.173",
"9.0.0.174",
"9.0.0.175",
"9.0.0.176",
"9.0.0.177",
"9.0.0.178",
"9.0.0.179",
"9.0.0.180",
"9.0.0.181",
"9.0.0.182",
"9.0.0.183",
"9.0.0.184",
"9.0.0.185",
"9.0.0.186",
"9.0.0.187",
"9.0.0.188",
"9.0.0.189",
"9.0.0.190",
"9.0.0.191",
"9.0.0.192",
"9.0.0.193",
"9.0.0.194",
"9.0.0.195",
"9.0.0.196",
"9.0.0.197",
"9.0.0.198",
"9.0.0.199",
"9.0.0.200",
"9.0.0.201",
"9.0.0.202",
"9.0.0.203",
"9.0.0.204",
"9.0.0.205",
"9.0.0.206",
"9.0.0.207",
"9.0.0.208",
"9.0.0.209",
"9.0.0.210",
"9.0.0.211",
"9.0.0.212",
"9.0.0.213",
"9.0.0.214",
"9.0.0.215",
"9.0.0.216",
"9.0.0.217",
"9.0.0.218",
"9.0.0.219",
"9.0.0.220",
"9.0.0.221",
"9.0.0.222",
"9.0.0.223",
"9.0.0.224",
"9.0.0.225",
"9.0.0.226",
"9.0.0.227",
"9.0.0.228",
"9.0.0.229",
"9.0.0.230",
"9.0.0.231",
"9.0.0.232",
"9.0.0.233",
"9.0.0.234",
"9.0.0.235",
"9.0.0.236",
"9.0.0.237",
"9.0.0.238",
"9.0.0.239",
"9.0.0.240",
"9.0.0.241",
"9.0.0.242",
"9.0.0.243",
"9.0.0.244",
"9.0.0.245",
"9.0.0.246",
"9.0.0.247",
"9.0.0.248",
"9.0.0.249",
"9.0.0.250",
"9.0.0.251",
"9.0.0.252",
"9.0.0.253",
"9.0.0.254",
"9.0.0.255",
"9.0.1.0",
"9.0.1.1",
"9.0.1.2",
"9.0.1.3",
"9.0.1.4",
"9.0.1.5",
"9.0.1.6",
"9.0.1.7",
"9.0.1.8",
"9.0.1.9",
"9.0.1.10",
"9.0.1.11",
"9.0.1.12",
"9.0.1.13",
"9.0.1.14",
"9.0.1.15",
"9.0.1.16",
"9.0.1.17",
"9.0.1.18",
"9.0.1.19",
"9.0.1.20",
"9.0.1.21",
"9.0.1.22",
"9.0.1.23",
"9.0.1.24",
"9.0.1.25",
"9.0.1.26",
"9.0.1.27",
"9.0.1.28",
"9.0.1.29",
"9.0.1.30",
"9.0.1.31",
"9.0.1.32",
"9.0.1.33",
"9.0.1.34",
"9.0.1.35",
"9.0.1.36",
"9.0.1.37",
"9.0.1.38",
"9.0.1.39",
"9.0.1.40",
"9.0.1.41",
"9.0.1.42",
"9.0.1.43",
"9.0.1.44",
"9.0.1.45",
"9.0.1.46",
"9.0.1.47",
"9.0.1.48",
"9.0.1.49",
"9.0.1.50",
"9.0.1.51",
"9.0.1.52",
"9.0.1.53",
"9.0.1.54",
"9.0.1.55",
"9.0.1.56",
"9.0.1.57",
"9.0.1.58",
"9.0.1.59",
"9.0.1.60",
"9.0.1.61",
"9.0.1.62",
"9.0.1.63",
"9.0.1.64",
"9.0.1.65",
"9.0.1.66",
"9.0.1.67",
"9.0.1.68",
"9.0.1.69",
"9.0.1.70",
"9.0.1.71",
"9.0.1.72",
"9.0.1.73",
"9.0.1.74",
"9.0.1.75",
"9.0.1.76",
"9.0.1.77",
"9.0.1.78",
"9.0.1.79",
"9.0.1.80",
"9.0.1.81",
"9.0.1.82",
"9.0.1.83",
"9.0.1.84",
"9.0.1.85",
"9.0.1.86",
"9.0.1.87",
"9.0.1.88",
"9.0.1.89",
"9.0.1.90",
"9.0.1.91",
"9.0.1.92",
"9.0.1.93",
"9.0.1.94",
"9.0.1.95",
"9.0.1.96",
"9.0.1.97",
"9.0.1.98",
"9.0.1.99",
"9.0.1.100",
"9.0.1.101",
"9.0.1.102",
"9.0.1.103",
"9.0.1.104",
"9.0.1.105",
"9.0.1.106",
"9.0.1.107",
"9.0.1.108",
"9.0.1.109",
"9.0.1.110",
"9.0.1.111",
"9.0.1.112",
"9.0.1.113",
"9.0.1.114",
"9.0.1.115",
"9.0.1.116",
"9.0.1.117",
"9.0.1.118",
"9.0.1.119",
"9.0.1.120",
"9.0.1.121",
"9.0.1.122",
"9.0.1.123",
"9.0.1.124",
"9.0.1.125",
"9.0.1.126",
"9.0.1.127",
"9.0.1.128",
"9.0.1.129",
"9.0.1.130",
"9.0.1.131",
"9.0.1.132",
"9.0.1.133",
"9.0.1.134",
"9.0.1.135",
"9.0.1.136",
"9.0.1.137",
"9.0.1.138",
"9.0.1.139",
"9.0.1.140",
"9.0.1.141",
"9.0.1.142",
"9.0.1.143",
"9.0.1.144",
"9.0.1.145",
"9.0.1.146",
"9.0.1.147",
"9.0.1.148",
"9.0.1.149",
"9.0.1.150",
"9.0.1.151",
"9.0.1.152",
"9.0.1.153",
"9.0.1.154",
"9.0.1.155",
"9.0.1.156",
"9.0.1.157",
"9.0.1.158",
"9.0.1.159",
"9.0.1.160",
"9.0.1.161",
"9.0.1.162",
"9.0.1.163",
"9.0.1.164",
"9.0.1.165",
"9.0.1.166",
"9.0.1.167",
"9.0.1.168",
"9.0.1.169",
"9.0.1.170",
"9.0.1.171",
"9.0.1.172",
"9.0.1.173",
"9.0.1.174",
"9.0.1.175",
"9.0.1.176",
"9.0.1.177",
"9.0.1.178",
"9.0.1.179",
"9.0.1.180",
"9.0.1.181",
"9.0.1.182",
"9.0.1.183",
"9.0.1.184",
"9.0.1.185",
"9.0.1.186",
"9.0.1.187",
"9.0.1.188",
"9.0.1.189",
"9.0.1.190",
"9.0.1.191",
"9.0.1.192",
"9.0.1.193",
"9.0.1.194",
"9.0.1.195",
"9.0.1.196",
"9.0.1.197",
"9.0.1.198",
"9.0.1.199",
"9.0.1.200",
"9.0.1.201",
"9.0.1.202",
"9.0.1.203",
"9.0.1.204",
"9.0.1.205",
"9.0.1.206",
"9.0.1.207",
"9.0.1.208",
"9.0.1.209",
"9.0.1.210",
"9.0.1.211",
"9.0.1.212",
"9.0.1.213",
"9.0.1.214",
"9.0.1.215",
"9.0.1.216",
"9.0.1.217",
"9.0.1.218",
"9.0.1.219",
"9.0.1.220",
"9.0.1.221",
"9.0.1.222",
"9.0.1.223",
"9.0.1.224",
"9.0.1.225",
"9.0.1.226",
"9.0.1.227",
"9.0.1.228",
"9.0.1.229",
"9.0.1.230",
"9.0.1.231",
"9.0.1.232",
"9.0.1.233",
"9.0.1.234",
"9.0.1.235",
"9.0.1.236",
"9.0.1.237",
"9.0.1.238",
"9.0.1.239",
"9.0.1.240",
"9.0.1.241",
"9.0.1.242",
"9.0.1.243",
"9.0.1.244",
"9.0.1.245",
"9.0.1.246",
"9.0.1.247",
"9.0.1.248",
"9.0.1.249",
"9.0.1.250",
"9.0.1.251",
"9.0.1.252",
"9.0.1.253",
"9.0.1.254",
"9.0.1.255",
"9.0.2.0",
"9.0.2.1",
"9.0.2.2",
"9.0.2.3",
"9.0.2.4",
"9.0.2.5",
"9.0.2.6",
"9.0.2.7",
"9.0.2.8",
"9.0.2.9",
"9.0.2.10",
"9.0.2.11",
"9.0.2.12",
"9.0.2.13",
"9.0.2.14",
"9.0.2.15",
"9.0.2.16",
"9.0.2.17",
"9.0.2.18",
"9.0.2.19",
"9.0.2.20",
"9.0.2.21",
"9.0.2.22",
"9.0.2.23",
"9.0.2.24",
"9.0.2.25",
"9.0.2.26",
"9.0.2.27",
"9.0.2.28",
"9.0.2.29",
"9.0.2.30",
"9.0.2.31",
"9.0.2.32",
"9.0.2.33",
"9.0.2.34",
"9.0.2.35",
"9.0.2.36",
"9.0.2.37",
"9.0.2.38",
"9.0.2.39",
"9.0.2.40",
"9.0.2.41",
"9.0.2.42",
"9.0.2.43",
"9.0.2.44",
"9.0.2.45",
"9.0.2.46",
"9.0.2.47",
"9.0.2.48",
"9.0.2.49",
"9.0.2.50",
"9.0.2.51",
"9.0.2.52",
"9.0.2.53",
"9.0.2.54",
"9.0.2.55",
"9.0.2.56",
"9.0.2.57",
"9.0.2.58",
"9.0.2.59",
"9.0.2.60",
"9.0.2.61",
"9.0.2.62",
"9.0.2.63",
"9.0.2.64",
"9.0.2.65",
"9.0.2.66",
"9.0.2.67",
"9.0.2.68",
"9.0.2.69",
"9.0.2.70",
"9.0.2.71",
"9.0.2.72",
"9.0.2.73",
"9.0.2.74",
"9.0.2.75",
"9.0.2.76",
"9.0.2.77",
"9.0.2.78",
"9.0.2.79",
"9.0.2.80",
"9.0.2.81",
"9.0.2.82",
"9.0.2.83",
"9.0.2.84",
"9.0.2.85",
"9.0.2.86",
"9.0.2.87",
"9.0.2.88",
"9.0.2.89",
"9.0.2.90",
"9.0.2.91",
"9.0.2.92",
"9.0.2.93",
"9.0.2.94",
"9.0.2.95",
"9.0.2.96",
"9.0.2.97",
"9.0.2.98",
"9.0.2.99",
"9.0.2.100",
"9.0.2.101",
"9.0.2.102",
"9.0.2.103",
"9.0.2.104",
"9.0.2.105",
"9.0.2.106",
"9.0.2.107",
"9.0.2.108",
"9.0.2.109",
"9.0.2.110",
"9.0.2.111",
"9.0.2.112",
"9.0.2.113",
"9.0.2.114",
"9.0.2.115",
"9.0.2.116",
"9.0.2.117",
"9.0.2.118",
"9.0.2.119",
"9.0.2.120",
"9.0.2.121",
"9.0.2.122",
"9.0.2.123",
"9.0.2.124",
"9.0.2.125",
"9.0.2.126",
"9.0.2.127",
"9.0.2.128",
"9.0.2.129",
"9.0.2.130",
"9.0.2.131",
"9.0.2.132",
"9.0.2.133",
"9.0.2.134",
"9.0.2.135",
"9.0.2.136",
"9.0.2.137",
"9.0.2.138",
"9.0.2.139",
"9.0.2.140",
"9.0.2.141",
"9.0.2.142",
"9.0.2.143",
"9.0.2.144",
"9.0.2.145",
"9.0.2.146",
"9.0.2.147",
"9.0.2.148",
"9.0.2.149",
"9.0.2.150",
"9.0.2.151",
"9.0.2.152",
"9.0.2.153",
"9.0.2.154",
"9.0.2.155",
"9.0.2.156",
"9.0.2.157",
"9.0.2.158",
"9.0.2.159",
"9.0.2.160",
"9.0.2.161",
"9.0.2.162",
"9.0.2.163",
"9.0.2.164",
"9.0.2.165",
"9.0.2.166",
"9.0.2.167",
"9.0.2.168",
"9.0.2.169",
"9.0.2.170",
"9.0.2.171",
"9.0.2.172",
"9.0.2.173",
"9.0.2.174",
"9.0.2.175",
"9.0.2.176",
"9.0.2.177",
"9.0.2.178",
"9.0.2.179",
"9.0.2.180",
"9.0.2.181",
"9.0.2.182",
"9.0.2.183",
"9.0.2.184",
"9.0.2.185",
"9.0.2.186",
"9.0.2.187",
"9.0.2.188",
"9.0.2.189",
"9.0.2.190",
"9.0.2.191",
"9.0.2.192",
"9.0.2.193",
"9.0.2.194",
"9.0.2.195",
"9.0.2.196",
"9.0.2.197",
"9.0.2.198",
"9.0.2.199",
"9.0.2.200",
"9.0.2.201",
"9.0.2.202",
"9.0.2.203",
"9.0.2.204",
"9.0.2.205",
"9.0.2.206",
"9.0.2.207",
"9.0.2.208",
"9.0.2.209",
"9.0.2.210",
"9.0.2.211",
"9.0.2.212",
"9.0.2.213",
"9.0.2.214",
"9.0.2.215",
"9.0.2.216",
"9.0.2.217",
"9.0.2.218",
"9.0.2.219",
"9.0.2.220",
"9.0.2.221",
"9.0.2.222",
"9.0.2.223",
"9.0.2.224",
"9.0.2.225",
"9.0.2.226",
"9.0.2.227",
"9.0.2.228",
"9.0.2.229",
"9.0.2.230",
"9.0.2.231",
"9.0.2.232",
"9.0.2.233",
"9.0.2.234",
"9.0.2.235",
"9.0.2.236",
"9.0.2.237",
"9.0.2.238",
"9.0.2.239",
"9.0.2.240",
"9.0.2.241",
"9.0.2.242",
"9.0.2.243",
"9.0.2.244",
"9.0.2.245",
"9.0.2.246",
"9.0.2.247",
"9.0.2.248",
"9.0.2.249",
"9.0.2.250",
"9.0.2.251",
"9.0.2.252",
"9.0.2.253",
"9.0.2.254",
"9.0.2.255",
"9.0.3.0",
"9.0.3.1",
"9.0.3.2",
"9.0.3.3",
"9.0.3.4",
"9.0.3.5",
"9.0.3.6",
"9.0.3.7",
"9.0.3.8",
"9.0.3.9",
"9.0.3.10",
"9.0.3.11",
"9.0.3.12",
"9.0.3.13",
"9.0.3.14",
"9.0.3.15",
"9.0.3.16",
"9.0.3.17",
"9.0.3.18",
"9.0.3.19",
"9.0.3.20",
"9.0.3.21",
"9.0.3.22",
"9.0.3.23",
"9.0.3.24",
"9.0.3.25",
"9.0.3.26",
"9.0.3.27",
"9.0.3.28",
"9.0.3.29",
"9.0.3.30",
"9.0.3.31",
"9.0.3.32",
"9.0.3.33",
"9.0.3.34",
"9.0.3.35",
"9.0.3.36",
"9.0.3.37",
"9.0.3.38",
"9.0.3.39",
"9.0.3.40",
"9.0.3.41",
"9.0.3.42",
"9.0.3.43",
"9.0.3.44",
"9.0.3.45",
"9.0.3.46",
"9.0.3.47",
"9.0.3.48",
"9.0.3.49",
"9.0.3.50",
"9.0.3.51",
"9.0.3.52",
"9.0.3.53",
"9.0.3.54",
"9.0.3.55",
"9.0.3.56",
"9.0.3.57",
"9.0.3.58",
"9.0.3.59",
"9.0.3.60",
"9.0.3.61",
"9.0.3.62",
"9.0.3.63",
"9.0.3.64",
"9.0.3.65",
"9.0.3.66",
"9.0.3.67",
"9.0.3.68",
"9.0.3.69",
"9.0.3.70",
"9.0.3.71",
"9.0.3.72",
"9.0.3.73",
"9.0.3.74",
"9.0.3.75",
"9.0.3.76",
"9.0.3.77",
"9.0.3.78",
"9.0.3.79",
"9.0.3.80",
"9.0.3.81",
"9.0.3.82",
"9.0.3.83",
"9.0.3.84",
"9.0.3.85",
"9.0.3.86",
"9.0.3.87",
"9.0.3.88",
"9.0.3.89",
"9.0.3.90",
"9.0.3.91",
"9.0.3.92",
"9.0.3.93",
"9.0.3.94",
"9.0.3.95",
"9.0.3.96",
"9.0.3.97",
"9.0.3.98",
"9.0.3.99",
"9.0.3.100",
"9.0.3.101",
"9.0.3.102",
"9.0.3.103",
"9.0.3.104",
"9.0.3.105",
"9.0.3.106",
"9.0.3.107",
"9.0.3.108",
"9.0.3.109",
"9.0.3.110",
"9.0.3.111",
"9.0.3.112",
"9.0.3.113",
"9.0.3.114",
"9.0.3.115",
"9.0.3.116",
"9.0.3.117",
"9.0.3.118",
"9.0.3.119",
"9.0.3.120",
"9.0.3.121",
"9.0.3.122",
"9.0.3.123",
"9.0.3.124",
"9.0.3.125",
"9.0.3.126",
"9.0.3.127",
"9.0.3.128",
"9.0.3.129",
"9.0.3.130",
"9.0.3.131",
"9.0.3.132",
"9.0.3.133",
"9.0.3.134",
"9.0.3.135",
"9.0.3.136",
"9.0.3.137",
"9.0.3.138",
"9.0.3.139",
"9.0.3.140",
"9.0.3.141",
"9.0.3.142",
"9.0.3.143",
"9.0.3.144",
"9.0.3.145",
"9.0.3.146",
"9.0.3.147",
"9.0.3.148",
"9.0.3.149",
"9.0.3.150",
"9.0.3.151",
"9.0.3.152",
"9.0.3.153",
"9.0.3.154",
"9.0.3.155",
"9.0.3.156",
"9.0.3.157",
"9.0.3.158",
"9.0.3.159",
"9.0.3.160",
"9.0.3.161",
"9.0.3.162",
"9.0.3.163",
"9.0.3.164",
"9.0.3.165",
"9.0.3.166",
"9.0.3.167",
"9.0.3.168",
"9.0.3.169",
"9.0.3.170",
"9.0.3.171",
"9.0.3.172",
"9.0.3.173",
"9.0.3.174",
"9.0.3.175",
"9.0.3.176",
"9.0.3.177",
"9.0.3.178",
"9.0.3.179",
"9.0.3.180",
"9.0.3.181",
"9.0.3.182",
"9.0.3.183",
"9.0.3.184",
"9.0.3.185",
"9.0.3.186",
"9.0.3.187",
"9.0.3.188",
"9.0.3.189",
"9.0.3.190",
"9.0.3.191",
"9.0.3.192",
"9.0.3.193",
"9.0.3.194",
"9.0.3.195",
"9.0.3.196",
"9.0.3.197",
"9.0.3.198",
"9.0.3.199",
"9.0.3.200",
"9.0.3.201",
"9.0.3.202",
"9.0.3.203",
"9.0.3.204",
"9.0.3.205",
"9.0.3.206",
"9.0.3.207",
"9.0.3.208",
"9.0.3.209",
"9.0.3.210",
"9.0.3.211",
"9.0.3.212",
"9.0.3.213",
"9.0.3.214",
"9.0.3.215",
"9.0.3.216",
"9.0.3.217",
"9.0.3.218",
"9.0.3.219",
"9.0.3.220",
"9.0.3.221",
"9.0.3.222",
"9.0.3.223",
"9.0.3.224",
"9.0.3.225",
"9.0.3.226",
"9.0.3.227",
"9.0.3.228",
"9.0.3.229",
"9.0.3.230",
"9.0.3.231",
"9.0.3.232",
"9.0.3.233",
"9.0.3.234",
"9.0.3.235",
"9.0.3.236",
"9.0.3.237",
"9.0.3.238",
"9.0.3.239",
"9.0.3.240",
"9.0.3.241",
"9.0.3.242",
"9.0.3.243",
"9.0.3.244",
"9.0.3.245",
"9.0.3.246",
"9.0.3.247",
"9.0.3.248",
"9.0.3.249",
"9.0.3.250",
"9.0.3.251",
"9.0.3.252",
"9.0.3.253",
"9.0.3.254",
"9.0.3.255",
"9.0.4.0",
"9.0.4.1",
"9.0.4.2",
"9.0.4.3",
"9.0.4.4",
"9.0.4.5",
"9.0.4.6",
"9.0.4.7",
"9.0.4.8",
"9.0.4.9",
"9.0.4.10",
"9.0.4.11",
"9.0.4.12",
"9.0.4.13",
"9.0.4.14",
"9.0.4.15",
"9.0.4.16",
"9.0.4.17",
"9.0.4.18",
"9.0.4.19",
"9.0.4.20",
"9.0.4.21",
"9.0.4.22",
"9.0.4.23",
"9.0.4.24",
"9.0.4.25",
"9.0.4.26",
"9.0.4.27",
"9.0.4.28",
"9.0.4.29",
"9.0.4.30",
"9.0.4.31",
"9.0.4.32",
"9.0.4.33",
"9.0.4.34",
"9.0.4.35",
"9.0.4.36",
"9.0.4.37",
"9.0.4.38",
"9.0.4.39",
"9.0.4.40",
"9.0.4.41",
"9.0.4.42",
"9.0.4.43",
"9.0.4.44",
"9.0.4.45",
"9.0.4.46",
"9.0.4.47",
"9.0.4.48",
"9.0.4.49",
"9.0.4.50",
"9.0.4.51",
"9.0.4.52",
"9.0.4.53",
"9.0.4.54",
"9.0.4.55",
"9.0.4.56",
"9.0.4.57",
"9.0.4.58",
"9.0.4.59",
"9.0.4.60",
"9.0.4.61",
"9.0.4.62",
"9.0.4.63",
"9.0.4.64",
"9.0.4.65",
"9.0.4.66",
"9.0.4.67",
"9.0.4.68",
"9.0.4.69",
"9.0.4.70",
"9.0.4.71",
"9.0.4.72",
"9.0.4.73",
"9.0.4.74",
"9.0.4.75",
"9.0.4.76",
"9.0.4.77",
"9.0.4.78",
"9.0.4.79",
"9.0.4.80",
"9.0.4.81",
"9.0.4.82",
"9.0.4.83",
"9.0.4.84",
"9.0.4.85",
"9.0.4.86",
"9.0.4.87",
"9.0.4.88",
"9.0.4.89",
"9.0.4.90",
"9.0.4.91",
"9.0.4.92",
"9.0.4.93",
"9.0.4.94",
"9.0.4.95",
"9.0.4.96",
"9.0.4.97",
"9.0.4.98",
"9.0.4.99",
"9.0.4.100",
"9.0.4.101",
"9.0.4.102",
"9.0.4.103",
"9.0.4.104",
"9.0.4.105",
"9.0.4.106",
"9.0.4.107",
"9.0.4.108",
"9.0.4.109",
"9.0.4.110",
"9.0.4.111",
"9.0.4.112",
"9.0.4.113",
"9.0.4.114",
"9.0.4.115",
"9.0.4.116",
"9.0.4.117",
"9.0.4.118",
"9.0.4.119",
"9.0.4.120",
"9.0.4.121",
"9.0.4.122",
"9.0.4.123",
"9.0.4.124",
"9.0.4.125",
"9.0.4.126",
"9.0.4.127",
"9.0.4.128",
"9.0.4.129",
"9.0.4.130",
"9.0.4.131",
"9.0.4.132",
"9.0.4.133",
"9.0.4.134",
"9.0.4.135",
"9.0.4.136",
"9.0.4.137",
"9.0.4.138",
"9.0.4.139",
"9.0.4.140",
"9.0.4.141",
"9.0.4.142",
"9.0.4.143",
"9.0.4.144",
"9.0.4.145",
"9.0.4.146",
"9.0.4.147",
"9.0.4.148",
"9.0.4.149",
"9.0.4.150",
"9.0.4.151",
"9.0.4.152",
"9.0.4.153",
"9.0.4.154",
"9.0.4.155",
"9.0.4.156",
"9.0.4.157",
"9.0.4.158",
"9.0.4.159",
"9.0.4.160",
"9.0.4.161",
"9.0.4.162",
"9.0.4.163",
"9.0.4.164",
"9.0.4.165",
"9.0.4.166",
"9.0.4.167",
"9.0.4.168",
"9.0.4.169",
"9.0.4.170",
"9.0.4.171",
"9.0.4.172",
"9.0.4.173",
"9.0.4.174",
"9.0.4.175",
"9.0.4.176",
"9.0.4.177",
"9.0.4.178",
"9.0.4.179",
"9.0.4.180",
"9.0.4.181",
"9.0.4.182",
"9.0.4.183",
"9.0.4.184",
"9.0.4.185",
"9.0.4.186",
"9.0.4.187",
"9.0.4.188",
"9.0.4.189",
"9.0.4.190",
"9.0.4.191",
"9.0.4.192",
"9.0.4.193",
"9.0.4.194",
"9.0.4.195",
"9.0.4.196",
"9.0.4.197",
"9.0.4.198",
"9.0.4.199",
"9.0.4.200",
"9.0.4.201",
"9.0.4.202",
"9.0.4.203",
"9.0.4.204",
"9.0.4.205",
"9.0.4.206",
"9.0.4.207",
"9.0.4.208",
"9.0.4.209",
"9.0.4.210",
"9.0.4.211",
"9.0.4.212",
"9.0.4.213",
"9.0.4.214",
"9.0.4.215",
"9.0.4.216",
"9.0.4.217",
"9.0.4.218",
"9.0.4.219",
"9.0.4.220",
"9.0.4.221",
"9.0.4.222",
"9.0.4.223",
"9.0.4.224",
"9.0.4.225",
"9.0.4.226",
"9.0.4.227",
"9.0.4.228",
"9.0.4.229",
"9.0.4.230",
"9.0.4.231",
"9.0.4.232",
"9.0.4.233",
"9.0.4.234",
"9.0.4.235",
"9.0.4.236",
"9.0.4.237",
"9.0.4.238",
"9.0.4.239",
"9.0.4.240",
"9.0.4.241",
"9.0.4.242",
"9.0.4.243",
"9.0.4.244",
"9.0.4.245",
"9.0.4.246",
"9.0.4.247",
"9.0.4.248",
"9.0.4.249",
"9.0.4.250",
"9.0.4.251",
"9.0.4.252",
"9.0.4.253",
"9.0.4.254",
"9.0.4.255",
"9.0.5.0",
"9.0.5.1",
"9.0.5.2",
"9.0.5.3",
"9.0.5.4",
"9.0.5.5",
"9.0.5.6",
"9.0.5.7",
"9.0.5.8",
"9.0.5.9",
"9.0.5.10",
"9.0.5.11",
"9.0.5.12",
"9.0.5.13",
"9.0.5.14",
"9.0.5.15",
"9.0.5.16",
"9.0.5.17",
"9.0.5.18",
"9.0.5.19",
"9.0.5.20",
"9.0.5.21",
"9.0.5.22",
"9.0.5.23",
"9.0.5.24",
"9.0.5.25",
"9.0.5.26",
"9.0.5.27",
"9.0.5.28",
"9.0.5.29",
"9.0.5.30",
"9.0.5.31",
"9.0.5.32",
"9.0.5.33",
"9.0.5.34",
"9.0.5.35",
"9.0.5.36",
"9.0.5.37",
"9.0.5.38",
"9.0.5.39",
"9.0.5.40",
"9.0.5.41",
"9.0.5.42",
"9.0.5.43",
"9.0.5.44",
"9.0.5.45",
"9.0.5.46",
"9.0.5.47",
"9.0.5.48",
"9.0.5.49",
"9.0.5.50",
"9.0.5.51",
"9.0.5.52",
"9.0.5.53",
"9.0.5.54",
"9.0.5.55",
"9.0.5.56",
"9.0.5.57",
"9.0.5.58",
"9.0.5.59",
"9.0.5.60",
"9.0.5.61",
"9.0.5.62",
"9.0.5.63",
"9.0.5.64",
"9.0.5.65",
"9.0.5.66",
"9.0.5.67",
"9.0.5.68",
"9.0.5.69",
"9.0.5.70",
"9.0.5.71",
"9.0.5.72",
"9.0.5.73",
"9.0.5.74",
"9.0.5.75",
"9.0.5.76",
"9.0.5.77",
"9.0.5.78",
"9.0.5.79",
"9.0.5.80",
"9.0.5.81",
"9.0.5.82",
"9.0.5.83",
"9.0.5.84",
"9.0.5.85",
"9.0.5.86",
"9.0.5.87",
"9.0.5.88",
"9.0.5.89",
"9.0.5.90",
"9.0.5.91",
"9.0.5.92",
"9.0.5.93",
"9.0.5.94",
"9.0.5.95",
"9.0.5.96",
"9.0.5.97",
"9.0.5.98",
"9.0.5.99",
"9.0.5.100",
"9.0.5.101",
"9.0.5.102",
"9.0.5.103",
"9.0.5.104",
"9.0.5.105",
"9.0.5.106",
"9.0.5.107",
"9.0.5.108",
"9.0.5.109",
"9.0.5.110",
"9.0.5.111",
"9.0.5.112",
"9.0.5.113",
"9.0.5.114",
"9.0.5.115",
"9.0.5.116",
"9.0.5.117",
"9.0.5.118",
"9.0.5.119",
"9.0.5.120",
"9.0.5.121",
"9.0.5.122",
"9.0.5.123",
"9.0.5.124",
"9.0.5.125",
"9.0.5.126",
"9.0.5.127",
"9.0.5.128",
"9.0.5.129",
"9.0.5.130",
"9.0.5.131",
"9.0.5.132",
"9.0.5.133",
"9.0.5.134",
"9.0.5.135",
"9.0.5.136",
"9.0.5.137",
"9.0.5.138",
"9.0.5.139",
"9.0.5.140",
"9.0.5.141",
"9.0.5.142",
"9.0.5.143",
"9.0.5.144",
"9.0.5.145",
"9.0.5.146",
"9.0.5.147",
"9.0.5.148",
"9.0.5.149",
"9.0.5.150",
"9.0.5.151",
"9.0.5.152",
"9.0.5.153",
"9.0.5.154",
"9.0.5.155",
"9.0.5.156",
"9.0.5.157",
"9.0.5.158",
"9.0.5.159",
"9.0.5.160",
"9.0.5.161",
"9.0.5.162",
"9.0.5.163",
"9.0.5.164",
"9.0.5.165",
"9.0.5.166",
"9.0.5.167",
"9.0.5.168",
"9.0.5.169",
"9.0.5.170",
"9.0.5.171",
"9.0.5.172",
"9.0.5.173",
"9.0.5.174",
"9.0.5.175",
"9.0.5.176",
"9.0.5.177",
"9.0.5.178",
"9.0.5.179",
"9.0.5.180",
"9.0.5.181",
"9.0.5.182",
"9.0.5.183",
"9.0.5.184",
"9.0.5.185",
"9.0.5.186",
"9.0.5.187",
"9.0.5.188",
"9.0.5.189",
"9.0.5.190",
"9.0.5.191",
"9.0.5.192",
"9.0.5.193",
"9.0.5.194",
"9.0.5.195",
"9.0.5.196",
"9.0.5.197",
"9.0.5.198",
"9.0.5.199",
"9.0.5.200",
"9.0.5.201",
"9.0.5.202",
"9.0.5.203",
"9.0.5.204",
"9.0.5.205",
"9.0.5.206",
"9.0.5.207",
"9.0.5.208",
"9.0.5.209",
"9.0.5.210",
"9.0.5.211",
"9.0.5.212",
"9.0.5.213",
"9.0.5.214",
"9.0.5.215",
"9.0.5.216",
"9.0.5.217",
"9.0.5.218",
"9.0.5.219",
"9.0.5.220",
"9.0.5.221",
"9.0.5.222",
"9.0.5.223",
"9.0.5.224",
"9.0.5.225",
"9.0.5.226",
"9.0.5.227",
"9.0.5.228",
"9.0.5.229",
"9.0.5.230",
"9.0.5.231",
"9.0.5.232",
"9.0.5.233",
"9.0.5.234",
"9.0.5.235",
"9.0.5.236",
"9.0.5.237",
"9.0.5.238",
"9.0.5.239",
"9.0.5.240",
"9.0.5.241",
"9.0.5.242",
"9.0.5.243",
"9.0.5.244",
"9.0.5.245",
"9.0.5.246",
"9.0.5.247",
"9.0.5.248",
"9.0.5.249",
"9.0.5.250",
"9.0.5.251",
"9.0.5.252",
"9.0.5.253",
"9.0.5.254",
"9.0.5.255",
"9.0.6.0",
"9.0.6.1",
"9.0.6.2",
"9.0.6.3",
"9.0.6.4",
"9.0.6.5",
"9.0.6.6",
"9.0.6.7",
"9.0.6.8",
"9.0.6.9",
"9.0.6.10",
"9.0.6.11",
"9.0.6.12",
"9.0.6.13",
"9.0.6.14",
"9.0.6.15",
"9.0.6.16",
"9.0.6.17",
"9.0.6.18",
"9.0.6.19",
"9.0.6.20",
"9.0.6.21",
"9.0.6.22",
"9.0.6.23",
"9.0.6.24",
"9.0.6.25",
"9.0.6.26",
"9.0.6.27",
"9.0.6.28",
"9.0.6.29",
"9.0.6.30",
"9.0.6.31",
"9.0.6.32",
"9.0.6.33",
"9.0.6.34",
"9.0.6.35",
"9.0.6.36",
"9.0.6.37",
"9.0.6.38",
"9.0.6.39",
"9.0.6.40",
"9.0.6.41",
"9.0.6.42",
"9.0.6.43",
"9.0.6.44",
"9.0.6.45",
"9.0.6.46",
"9.0.6.47",
"9.0.6.48",
"9.0.6.49",
"9.0.6.50",
"9.0.6.51",
"9.0.6.52",
"9.0.6.53",
"9.0.6.54",
"9.0.6.55",
"9.0.6.56",
"9.0.6.57",
"9.0.6.58",
"9.0.6.59",
"9.0.6.60",
"9.0.6.61",
"9.0.6.62",
"9.0.6.63",
"9.0.6.64",
"9.0.6.65",
"9.0.6.66",
"9.0.6.67",
"9.0.6.68",
"9.0.6.69",
"9.0.6.70",
"9.0.6.71",
"9.0.6.72",
"9.0.6.73",
"9.0.6.74",
"9.0.6.75",
"9.0.6.76",
"9.0.6.77",
"9.0.6.78",
"9.0.6.79",
"9.0.6.80",
"9.0.6.81",
"9.0.6.82",
"9.0.6.83",
"9.0.6.84",
"9.0.6.85",
"9.0.6.86",
"9.0.6.87",
"9.0.6.88",
"9.0.6.89",
"9.0.6.90",
"9.0.6.91",
"9.0.6.92",
"9.0.6.93",
"9.0.6.94",
"9.0.6.95",
"9.0.6.96",
"9.0.6.97",
"9.0.6.98",
"9.0.6.99",
"9.0.6.100",
"9.0.6.101",
"9.0.6.102",
"9.0.6.103",
"9.0.6.104",
"9.0.6.105",
"9.0.6.106",
"9.0.6.107",
"9.0.6.108",
"9.0.6.109",
"9.0.6.110",
"9.0.6.111",
"9.0.6.112",
"9.0.6.113",
"9.0.6.114",
"9.0.6.115",
"9.0.6.116",
"9.0.6.117",
"9.0.6.118",
"9.0.6.119",
"9.0.6.120",
"9.0.6.121",
"9.0.6.122",
"9.0.6.123",
"9.0.6.124",
"9.0.6.125",
"9.0.6.126",
"9.0.6.127",
"9.0.6.128",
"9.0.6.129",
"9.0.6.130",
"9.0.6.131",
"9.0.6.132",
"9.0.6.133",
"9.0.6.134",
"9.0.6.135",
"9.0.6.136",
"9.0.6.137",
"9.0.6.138",
"9.0.6.139",
"9.0.6.140",
"9.0.6.141",
"9.0.6.142",
"9.0.6.143",
"9.0.6.144",
"9.0.6.145",
"9.0.6.146",
"9.0.6.147",
"9.0.6.148",
"9.0.6.149",
"9.0.6.150",
"9.0.6.151",
"9.0.6.152",
"9.0.6.153",
"9.0.6.154",
"9.0.6.155",
"9.0.6.156",
"9.0.6.157",
"9.0.6.158",
"9.0.6.159",
"9.0.6.160",
"9.0.6.161",
"9.0.6.162",
"9.0.6.163",
"9.0.6.164",
"9.0.6.165",
"9.0.6.166",
"9.0.6.167",
"9.0.6.168",
"9.0.6.169",
"9.0.6.170",
"9.0.6.171",
"9.0.6.172",
"9.0.6.173",
"9.0.6.174",
"9.0.6.175",
"9.0.6.176",
"9.0.6.177",
"9.0.6.178",
"9.0.6.179",
"9.0.6.180",
"9.0.6.181",
"9.0.6.182",
"9.0.6.183",
"9.0.6.184",
"9.0.6.185",
"9.0.6.186",
"9.0.6.187",
"9.0.6.188",
"9.0.6.189",
"9.0.6.190",
"9.0.6.191",
"9.0.6.192",
"9.0.6.193",
"9.0.6.194",
"9.0.6.195",
"9.0.6.196",
"9.0.6.197",
"9.0.6.198",
"9.0.6.199",
"9.0.6.200",
"9.0.6.201",
"9.0.6.202",
"9.0.6.203",
"9.0.6.204",
"9.0.6.205",
"9.0.6.206",
"9.0.6.207",
"9.0.6.208",
"9.0.6.209",
"9.0.6.210",
"9.0.6.211",
"9.0.6.212",
"9.0.6.213",
"9.0.6.214",
"9.0.6.215",
"9.0.6.216",
"9.0.6.217",
"9.0.6.218",
"9.0.6.219",
"9.0.6.220",
"9.0.6.221",
"9.0.6.222",
"9.0.6.223",
"9.0.6.224",
"9.0.6.225",
"9.0.6.226",
"9.0.6.227",
"9.0.6.228",
"9.0.6.229",
"9.0.6.230",
"9.0.6.231",
"9.0.6.232",
"9.0.6.233",
"9.0.6.234",
"9.0.6.235",
"9.0.6.236",
"9.0.6.237",
"9.0.6.238",
"9.0.6.239",
"9.0.6.240",
"9.0.6.241",
"9.0.6.242",
"9.0.6.243",
"9.0.6.244",
"9.0.6.245",
"9.0.6.246",
"9.0.6.247",
"9.0.6.248",
"9.0.6.249",
"9.0.6.250",
"9.0.6.251",
"9.0.6.252",
"9.0.6.253",
"9.0.6.254",
"9.0.6.255",
"9.0.7.0",
"9.0.7.1",
"9.0.7.2",
"9.0.7.3",
"9.0.7.4",
"9.0.7.5",
"9.0.7.6",
"9.0.7.7",
"9.0.7.8",
"9.0.7.9",
"9.0.7.10",
"9.0.7.11",
"9.0.7.12",
"9.0.7.13",
"9.0.7.14",
"9.0.7.15",
"9.0.7.16",
"9.0.7.17",
"9.0.7.18",
"9.0.7.19",
"9.0.7.20",
"9.0.7.21",
"9.0.7.22",
"9.0.7.23",
"9.0.7.24",
"9.0.7.25",
"9.0.7.26",
"9.0.7.27",
"9.0.7.28",
"9.0.7.29",
"9.0.7.30",
"9.0.7.31",
"9.0.7.32",
"9.0.7.33",
"9.0.7.34",
"9.0.7.35",
"9.0.7.36",
"9.0.7.37",
"9.0.7.38",
"9.0.7.39",
"9.0.7.40",
"9.0.7.41",
"9.0.7.42",
"9.0.7.43",
"9.0.7.44",
"9.0.7.45",
"9.0.7.46",
"9.0.7.47",
"9.0.7.48",
"9.0.7.49",
"9.0.7.50",
"9.0.7.51",
"9.0.7.52",
"9.0.7.53",
"9.0.7.54",
"9.0.7.55",
"9.0.7.56",
"9.0.7.57",
"9.0.7.58",
"9.0.7.59",
"9.0.7.60",
"9.0.7.61",
"9.0.7.62",
"9.0.7.63",
"9.0.7.64",
"9.0.7.65",
"9.0.7.66",
"9.0.7.67",
"9.0.7.68",
"9.0.7.69",
"9.0.7.70",
"9.0.7.71",
"9.0.7.72",
"9.0.7.73",
"9.0.7.74",
"9.0.7.75",
"9.0.7.76",
"9.0.7.77",
"9.0.7.78",
"9.0.7.79",
"9.0.7.80",
"9.0.7.81",
"9.0.7.82",
"9.0.7.83",
"9.0.7.84",
"9.0.7.85",
"9.0.7.86",
"9.0.7.87",
"9.0.7.88",
"9.0.7.89",
"9.0.7.90",
"9.0.7.91",
"9.0.7.92",
"9.0.7.93",
"9.0.7.94",
"9.0.7.95",
"9.0.7.96",
"9.0.7.97",
"9.0.7.98",
"9.0.7.99",
"9.0.7.100",
"9.0.7.101",
"9.0.7.102",
"9.0.7.103",
"9.0.7.104",
"9.0.7.105",
"9.0.7.106",
"9.0.7.107",
"9.0.7.108",
"9.0.7.109",
"9.0.7.110",
"9.0.7.111",
"9.0.7.112",
"9.0.7.113",
"9.0.7.114",
"9.0.7.115",
"9.0.7.116",
"9.0.7.117",
"9.0.7.118",
"9.0.7.119",
"9.0.7.120",
"9.0.7.121",
"9.0.7.122",
"9.0.7.123",
"9.0.7.124",
"9.0.7.125",
"9.0.7.126",
"9.0.7.127",
"9.0.7.128",
"9.0.7.129",
"9.0.7.130",
"9.0.7.131",
"9.0.7.132",
"9.0.7.133",
"9.0.7.134",
"9.0.7.135",
"9.0.7.136",
"9.0.7.137",
"9.0.7.138",
"9.0.7.139",
"9.0.7.140",
"9.0.7.141",
"9.0.7.142",
"9.0.7.143",
"9.0.7.144",
"9.0.7.145",
"9.0.7.146",
"9.0.7.147",
"9.0.7.148",
"9.0.7.149",
"9.0.7.150",
"9.0.7.151",
"9.0.7.152",
"9.0.7.153",
"9.0.7.154",
"9.0.7.155",
"9.0.7.156",
"9.0.7.157",
"9.0.7.158",
"9.0.7.159",
"9.0.7.160",
"9.0.7.161",
"9.0.7.162",
"9.0.7.163",
"9.0.7.164",
"9.0.7.165",
"9.0.7.166",
"9.0.7.167",
"9.0.7.168",
"9.0.7.169",
"9.0.7.170",
"9.0.7.171",
"9.0.7.172",
"9.0.7.173",
"9.0.7.174",
"9.0.7.175",
"9.0.7.176",
"9.0.7.177",
"9.0.7.178",
"9.0.7.179",
"9.0.7.180",
"9.0.7.181",
"9.0.7.182",
"9.0.7.183",
"9.0.7.184",
"9.0.7.185",
"9.0.7.186",
"9.0.7.187",
"9.0.7.188",
"9.0.7.189",
"9.0.7.190",
"9.0.7.191",
"9.0.7.192",
"9.0.7.193",
"9.0.7.194",
"9.0.7.195",
"9.0.7.196",
"9.0.7.197",
"9.0.7.198",
"9.0.7.199",
"9.0.7.200",
"9.0.7.201",
"9.0.7.202",
"9.0.7.203",
"9.0.7.204",
"9.0.7.205",
"9.0.7.206",
"9.0.7.207",
"9.0.7.208",
"9.0.7.209",
"9.0.7.210",
"9.0.7.211",
"9.0.7.212",
"9.0.7.213",
"9.0.7.214",
"9.0.7.215",
"9.0.7.216",
"9.0.7.217",
"9.0.7.218",
"9.0.7.219",
"9.0.7.220",
"9.0.7.221",
"9.0.7.222",
"9.0.7.223",
"9.0.7.224",
"9.0.7.225",
"9.0.7.226",
"9.0.7.227",
"9.0.7.228",
"9.0.7.229",
"9.0.7.230",
"9.0.7.231",
"9.0.7.232",
"9.0.7.233",
"9.0.7.234",
"9.0.7.235",
"9.0.7.236",
"9.0.7.237",
"9.0.7.238",
"9.0.7.239",
"9.0.7.240",
"9.0.7.241",
"9.0.7.242",
"9.0.7.243",
"9.0.7.244",
"9.0.7.245",
"9.0.7.246",
"9.0.7.247",
"9.0.7.248",
"9.0.7.249",
"9.0.7.250",
"9.0.7.251",
"9.0.7.252",
"9.0.7.253",
"9.0.7.254",
"9.0.7.255",
"9.0.8.0",
"9.0.8.1",
"9.0.8.2",
"9.0.8.3",
"9.0.8.4",
"9.0.8.5",
"9.0.8.6",
"9.0.8.7",
"9.0.8.8",
"9.0.8.9",
"9.0.8.10",
"9.0.8.11",
"9.0.8.12",
"9.0.8.13",
"9.0.8.14",
"9.0.8.15",
"9.0.8.16",
"9.0.8.17",
"9.0.8.18",
"9.0.8.19",
"9.0.8.20",
"9.0.8.21",
"9.0.8.22",
"9.0.8.23",
"9.0.8.24",
"9.0.8.25",
"9.0.8.26",
"9.0.8.27",
"9.0.8.28",
"9.0.8.29",
"9.0.8.30",
"9.0.8.31",
"9.0.8.32",
"9.0.8.33",
"9.0.8.34",
"9.0.8.35",
"9.0.8.36",
"9.0.8.37",
"9.0.8.38",
"9.0.8.39",
"9.0.8.40",
"9.0.8.41",
"9.0.8.42",
"9.0.8.43",
"9.0.8.44",
"9.0.8.45",
"9.0.8.46",
"9.0.8.47",
"9.0.8.48",
"9.0.8.49",
"9.0.8.50",
"9.0.8.51",
"9.0.8.52",
"9.0.8.53",
"9.0.8.54",
"9.0.8.55",
"9.0.8.56",
"9.0.8.57",
"9.0.8.58",
"9.0.8.59",
"9.0.8.60",
"9.0.8.61",
"9.0.8.62",
"9.0.8.63",
"9.0.8.64",
"9.0.8.65",
"9.0.8.66",
"9.0.8.67",
"9.0.8.68",
"9.0.8.69",
"9.0.8.70",
"9.0.8.71",
"9.0.8.72",
"9.0.8.73",
"9.0.8.74",
"9.0.8.75",
"9.0.8.76",
"9.0.8.77",
"9.0.8.78",
"9.0.8.79",
"9.0.8.80",
"9.0.8.81",
"9.0.8.82",
"9.0.8.83",
"9.0.8.84",
"9.0.8.85",
"9.0.8.86",
"9.0.8.87",
"9.0.8.88",
"9.0.8.89",
"9.0.8.90",
"9.0.8.91",
"9.0.8.92",
"9.0.8.93",
"9.0.8.94",
"9.0.8.95",
"9.0.8.96",
"9.0.8.97",
"9.0.8.98",
"9.0.8.99",
"9.0.8.100",
"9.0.8.101",
"9.0.8.102",
"9.0.8.103",
"9.0.8.104",
"9.0.8.105",
"9.0.8.106",
"9.0.8.107",
"9.0.8.108",
"9.0.8.109",
"9.0.8.110",
"9.0.8.111",
"9.0.8.112",
"9.0.8.113",
"9.0.8.114",
"9.0.8.115",
"9.0.8.116",
"9.0.8.117",
"9.0.8.118",
"9.0.8.119",
"9.0.8.120",
"9.0.8.121",
"9.0.8.122",
"9.0.8.123",
"9.0.8.124",
"9.0.8.125",
"9.0.8.126",
"9.0.8.127",
"9.0.8.128",
"9.0.8.129",
"9.0.8.130",
"9.0.8.131",
"9.0.8.132",
"9.0.8.133",
"9.0.8.134",
"9.0.8.135",
"9.0.8.136",
"9.0.8.137",
"9.0.8.138",
"9.0.8.139",
"9.0.8.140",
"9.0.8.141",
"9.0.8.142",
"9.0.8.143",
"9.0.8.144",
"9.0.8.145",
"9.0.8.146",
"9.0.8.147",
"9.0.8.148",
"9.0.8.149",
"9.0.8.150",
"9.0.8.151",
"9.0.8.152",
"9.0.8.153",
"9.0.8.154",
"9.0.8.155",
"9.0.8.156",
"9.0.8.157",
"9.0.8.158",
"9.0.8.159",
"9.0.8.160",
"9.0.8.161",
"9.0.8.162",
"9.0.8.163",
"9.0.8.164",
"9.0.8.165",
"9.0.8.166",
"9.0.8.167",
"9.0.8.168",
"9.0.8.169",
"9.0.8.170",
"9.0.8.171",
"9.0.8.172",
"9.0.8.173",
"9.0.8.174",
"9.0.8.175",
"9.0.8.176",
"9.0.8.177",
"9.0.8.178",
"9.0.8.179",
"9.0.8.180",
"9.0.8.181",
"9.0.8.182",
"9.0.8.183",
"9.0.8.184",
"9.0.8.185",
"9.0.8.186",
"9.0.8.187",
"9.0.8.188",
"9.0.8.189",
"9.0.8.190",
"9.0.8.191",
"9.0.8.192",
"9.0.8.193",
"9.0.8.194",
"9.0.8.195",
"9.0.8.196",
"9.0.8.197",
"9.0.8.198",
"9.0.8.199",
"9.0.8.200",
"9.0.8.201",
"9.0.8.202",
"9.0.8.203",
"9.0.8.204",
"9.0.8.205",
"9.0.8.206",
"9.0.8.207",
"9.0.8.208",
"9.0.8.209",
"9.0.8.210",
"9.0.8.211",
"9.0.8.212",
"9.0.8.213",
"9.0.8.214",
"9.0.8.215",
"9.0.8.216",
"9.0.8.217",
"9.0.8.218",
"9.0.8.219",
"9.0.8.220",
"9.0.8.221",
"9.0.8.222",
"9.0.8.223",
"9.0.8.224",
"9.0.8.225",
"9.0.8.226",
"9.0.8.227",
"9.0.8.228",
"9.0.8.229",
"9.0.8.230",
"9.0.8.231",
"9.0.8.232",
"9.0.8.233",
"9.0.8.234",
"9.0.8.235",
"9.0.8.236",
"9.0.8.237",
"9.0.8.238",
"9.0.8.239",
"9.0.8.240",
"9.0.8.241",
"9.0.8.242",
"9.0.8.243",
"9.0.8.244",
"9.0.8.245",
"9.0.8.246",
"9.0.8.247",
"9.0.8.248",
"9.0.8.249",
"9.0.8.250",
"9.0.8.251",
"9.0.8.252",
"9.0.8.253",
"9.0.8.254",
"9.0.8.255",
"9.0.9.0",
"9.0.9.1",
"9.0.9.2",
"9.0.9.3",
"9.0.9.4",
"9.0.9.5",
"9.0.9.6",
"9.0.9.7",
"9.0.9.8",
"9.0.9.9",
"9.0.9.10",
"9.0.9.11",
"9.0.9.12",
"9.0.9.13",
"9.0.9.14",
"9.0.9.15",
"9.0.9.16",
"9.0.9.17",
"9.0.9.18",
"9.0.9.19",
"9.0.9.20",
"9.0.9.21",
"9.0.9.22",
"9.0.9.23",
"9.0.9.24",
"9.0.9.25",
"9.0.9.26",
"9.0.9.27",
"9.0.9.28",
"9.0.9.29",
"9.0.9.30",
"9.0.9.31",
"9.0.9.32",
"9.0.9.33",
"9.0.9.34",
"9.0.9.35",
"9.0.9.36",
"9.0.9.37",
"9.0.9.38",
"9.0.9.39",
"9.0.9.40",
"9.0.9.41",
"9.0.9.42",
"9.0.9.43",
"9.0.9.44",
"9.0.9.45",
"9.0.9.46",
"9.0.9.47",
"9.0.9.48",
"9.0.9.49",
"9.0.9.50",
"9.0.9.51",
"9.0.9.52",
"9.0.9.53",
"9.0.9.54",
"9.0.9.55",
"9.0.9.56",
"9.0.9.57",
"9.0.9.58",
"9.0.9.59",
"9.0.9.60",
"9.0.9.61",
"9.0.9.62",
"9.0.9.63",
"9.0.9.64",
"9.0.9.65",
"9.0.9.66",
"9.0.9.67",
"9.0.9.68",
"9.0.9.69",
"9.0.9.70",
"9.0.9.71",
"9.0.9.72",
"9.0.9.73",
"9.0.9.74",
"9.0.9.75",
"9.0.9.76",
"9.0.9.77",
"9.0.9.78",
"9.0.9.79",
"9.0.9.80",
"9.0.9.81",
"9.0.9.82",
"9.0.9.83",
"9.0.9.84",
"9.0.9.85",
"9.0.9.86",
"9.0.9.87",
"9.0.9.88",
"9.0.9.89",
"9.0.9.90",
"9.0.9.91",
"9.0.9.92",
"9.0.9.93",
"9.0.9.94",
"9.0.9.95",
"9.0.9.96",
"9.0.9.97",
"9.0.9.98",
"9.0.9.99",
"9.0.9.100",
"9.0.9.101",
"9.0.9.102",
"9.0.9.103",
"9.0.9.104",
"9.0.9.105",
"9.0.9.106",
"9.0.9.107",
"9.0.9.108",
"9.0.9.109",
"9.0.9.110",
"9.0.9.111",
"9.0.9.112",
"9.0.9.113",
"9.0.9.114",
"9.0.9.115",
"9.0.9.116",
"9.0.9.117",
"9.0.9.118",
"9.0.9.119",
"9.0.9.120",
"9.0.9.121",
"9.0.9.122",
"9.0.9.123",
"9.0.9.124",
"9.0.9.125",
"9.0.9.126",
"9.0.9.127",
"9.0.9.128",
"9.0.9.129",
"9.0.9.130",
"9.0.9.131",
"9.0.9.132",
"9.0.9.133",
"9.0.9.134",
"9.0.9.135",
"9.0.9.136",
"9.0.9.137",
"9.0.9.138",
"9.0.9.139",
"9.0.9.140",
"9.0.9.141",
"9.0.9.142",
"9.0.9.143",
"9.0.9.144",
"9.0.9.145",
"9.0.9.146",
"9.0.9.147",
"9.0.9.148",
"9.0.9.149",
"9.0.9.150",
"9.0.9.151",
"9.0.9.152",
"9.0.9.153",
"9.0.9.154",
"9.0.9.155",
"9.0.9.156",
"9.0.9.157",
"9.0.9.158",
"9.0.9.159",
"9.0.9.160",
"9.0.9.161",
"9.0.9.162",
"9.0.9.163",
"9.0.9.164",
"9.0.9.165",
"9.0.9.166",
"9.0.9.167",
"9.0.9.168",
"9.0.9.169",
"9.0.9.170",
"9.0.9.171",
"9.0.9.172",
"9.0.9.173",
"9.0.9.174",
"9.0.9.175",
"9.0.9.176",
"9.0.9.177",
"9.0.9.178",
"9.0.9.179",
"9.0.9.180",
"9.0.9.181",
"9.0.9.182",
"9.0.9.183",
"9.0.9.184",
"9.0.9.185",
"9.0.9.186",
"9.0.9.187",
"9.0.9.188",
"9.0.9.189",
"9.0.9.190",
"9.0.9.191",
"9.0.9.192",
"9.0.9.193",
"9.0.9.194",
"9.0.9.195",
"9.0.9.196"
],
"expect": {
"keyCount": 2500,
"httpRequests": 3
}
},
{
"name": "an-entry-error-is-classified-by-its-status",
"why": "A per-entry failure arrives as {status, error} with no headers, so a 429 there is always a spent allowance (never a throttle, which refuses the whole call with Retry-After) and a 500 is a server error. Neither is retried per entry; the whole call's retry rule is unchanged.",
"input": [
"1.1.1.1",
"8.8.8.8",
"9.9.9.9"
],
"expect": {
"keys": [
"1.1.1.1",
"8.8.8.8",
"9.9.9.9"
],
"errorKeys": [
"8.8.8.8",
"9.9.9.9"
],
"errorKinds": {
"8.8.8.8": "quota_exceeded",
"9.9.9.9": "server_error"
},
"httpRequests": 1
}
}
],
"middleware": {
"why": "The framework middleware contract: how a block condition is evaluated, and which conditions must be refused outright. Field names are the WIRE names; each SDK maps them to its own idiom exactly as it maps a response.",
"conditions": [
{
"name": "flag-true-matches",
"why": "The simplest condition there is: a served flag that is true.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "flag-true-against-false",
"why": "A served flag that is false does not match.",
"body": {
"ip": "1.1.1.1",
"is_vpn": false,
"is_hosting": false,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": false,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {},
"hosting": {},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "flag-absent-is-not-false",
"why": "The member is not in this plan, so the term can never match and must be reported. Absent means not-in-your-plan, never checked-and-no.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true
},
"condition": {
"is_hosting": true
},
"expect": {
"blocked": false,
"missing": [
"is_hosting"
]
}
},
{
"name": "nested-provider-exact",
"why": "A condition reaches the evidence fields, not just the flags.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true,
"vpn": {
"provider": "nordvpn"
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "nested-provider-case-insensitive",
"why": "Providers are lowercase slugs on the wire; a caller should not have to know that.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"vpn": {
"provider": "NordVPN"
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "nested-provider-mismatch",
"why": "A different provider does not match.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"vpn": {
"provider": "mullvad"
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "and-across-members",
"why": "Every member named must hold.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true,
"is_hosting": true
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "and-one-fails",
"why": "One failing term fails the whole condition.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true,
"is_tor": true
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "or-list-second-matches",
"why": "A list is OR: any one entry blocking is enough.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": [
{
"is_tor": true
},
{
"vpn": {
"provider": "nordvpn"
}
}
],
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "or-list-none-match",
"why": "A list where nothing matches does not block.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": [
{
"is_tor": true
},
{
"vpn": {
"provider": "mullvad"
}
}
],
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "array-any-of",
"why": "An array value is any-of, for an enum-like field.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"vpn": {
"confidence": [
"high",
"medium"
]
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "array-none-of",
"why": "An any-of that contains nothing the answer carries.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"vpn": {
"confidence": [
"low"
]
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "numeric-gte-inside",
"why": "The evidence counters are only useful with a threshold.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"gte": 5
}
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "numeric-gte-outside",
"why": "Below the threshold does not match.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"gte": 9
}
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "numeric-range-inside",
"why": "Every bound present must hold, so two of them are a range.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"gte": 5,
"lt": 100
}
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "numeric-exclusive-bound",
"why": "gt and lt are strict. Pinned because an off-by-one here reads as a working filter.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"gt": 7
}
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "numeric-inclusive-lower-bound",
"why": "gte INCLUDES the bound. hits is exactly 7 here, so a gte that compares strictly still passes every other numeric case and fails only this one.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"gte": 7
}
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "numeric-inclusive-upper-bound",
"why": "lte INCLUDES the bound, the mirror of the case above.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"lte": 7
}
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "numeric-exclusive-upper-bound",
"why": "lt EXCLUDES it. Together with numeric-exclusive-bound this pins all four comparators at the one value where inclusive and strict disagree.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits": {
"lt": 7
}
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "fractional-bound-on-an-integer-member",
"why": "Every numeric member the API serves is an integer, so the FRACTION has to come from the bound. Pinned because a comparison done in integers would round the bound and quietly widen or narrow the rule.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"resproxy": {
"hits_days_pct": {
"gte": 41.5
}
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "numeric-bound-on-absent-member",
"why": "A bound against a member this plan does not serve matches nothing and is reported.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true
},
"condition": {
"resproxy": {
"hits": {
"gte": 1
}
}
},
"expect": {
"blocked": false,
"missing": [
"resproxy"
]
}
},
{
"name": "numeric-upper-bound-on-absent-member",
"why": "lt on a member this plan does not serve matches nothing and is reported. A binding that reads the missing member as zero matches lt: 5 and blocks a visitor on data it never saw, which the gte case above cannot show.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true
},
"condition": {
"resproxy": {
"hits": {
"lt": 5
}
}
},
"expect": {
"blocked": false,
"missing": [
"resproxy"
]
}
},
{
"name": "numeric-inclusive-upper-bound-on-absent-member",
"why": "lte, the mirror of the case above: zero is inside lte: 5 too.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true
},
"condition": {
"resproxy": {
"hits": {
"lte": 5
}
}
},
"expect": {
"blocked": false,
"missing": [
"resproxy"
]
}
},
{
"name": "false-entry-is-ignored",
"why": "A false entry states nothing, so the remaining term decides. There is deliberately no way to write block-when-false, which would read as blocking everybody.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true,
"is_tor": false
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "null-entry-is-ignored",
"why": "Null is ignored for the same reason false is.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"is_vpn": true,
"is_cdn": null
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "empty-detail-is-a-real-false",
"why": "An empty detail object means the flag above it is false. That is a served answer, not a plan gap, so it must not be reported as missing.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {}
},
"condition": {
"tor": {
"provider": "anything"
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "bogon-is-exempt",
"why": "A locally answered bogon carries every member by construction, so reporting coverage from it would tell a free-tier caller they hold the full plan.",
"bogon": "10.0.0.1",
"condition": {
"is_hosting": true
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "pubproxy-detail-term-matches",
"why": "The public proxy detail is a member like the other families: a nested boolean term reaches it.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {},
"is_pubproxy": true,
"pubproxy": {
"entry": true,
"exit": false,
"protocols": [
"socks5"
],
"num_ports": 1,
"num_proxies": 0,
"last_seen": "2026-10-17",
"last_usable": "2026-10-16"
}
},
"condition": {
"is_pubproxy": true,
"pubproxy": {
"entry": true
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "pubproxy-detail-term-misses",
"why": "A nested term that disagrees with the served detail does not block.",
"body": {
"ip": "45.83.91.1",
"is_vpn": true,
"is_hosting": true,
"is_relay": false,
"is_tor": false,
"is_cdn": false,
"is_resproxy": true,
"is_dcproxy": false,
"is_mobproxy": false,
"vpn": {
"provider": "nordvpn",
"confidence": "high",
"method": "rdns",
"last_seen": "2026-09-01"
},
"hosting": {
"provider": "ovh",
"confidence": "medium",
"last_seen": "2026-09-01"
},
"relay": {},
"tor": {},
"cdn": {},
"resproxy": {
"provider": "brightdata",
"first_seen": "2026-06-01",
"last_seen": "2026-09-01",
"hits": 7,
"hits_days_pct": 42,
"providers_num": 2
},
"dcproxy": {},
"mobproxy": {},
"is_pubproxy": true,
"pubproxy": {
"entry": true,
"exit": false,
"protocols": [
"socks5"
],
"num_ports": 1,
"num_proxies": 0,
"last_seen": "2026-10-17",
"last_usable": "2026-10-16"
}
},
"condition": {
"pubproxy": {
"exit": true
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "location-country-matches",
"why": "location is a member like any other: a country term matches the served country, without regard to case, on the answer a lookup gets without a key.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"condition": {
"location": {
"country": "at"
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "location-country-any-of",
"why": "A list of countries is any-of, the way a country block list is written.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"condition": {
"location": {
"country": [
"DE",
"AT"
]
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "location-country-mismatch",
"why": "A country the address is not in does not block, and location is served, so nothing is missing.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"condition": {
"location": {
"country": "DE"
}
},
"expect": {
"blocked": false,
"missing": []
}
},
{
"name": "asn-type-matches",
"why": "asn is a member like any other: even an answer without a key says which kind of network announces the address.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"condition": {
"asn": {
"type": "hosting"
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "asn-number-matches",
"why": "The AS number compares as a number.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true,
"is_relay": false,
"is_tor": false,
"relay": {},
"tor": {},
"location": {
"continent": "EU",
"continent_name": "Europe",
"country": "AT",
"country_name": "Austria",
"timezone": "Europe/Vienna",
"currency_code": "EUR",
"currency_name": "Euro",
"currency_symbol": "€",
"flag_emoji": "🇦🇹",
"flag_unicode": "U+1F1E6 U+1F1F9"
},
"asn": {
"asn": 9009,
"name": "M247 Europe SRL",
"domain": "m247global.com",
"type": "hosting",
"prefix": "146.70.116.0/24"
}
},
"condition": {
"asn": {
"asn": 9009
}
},
"expect": {
"blocked": true,
"missing": []
}
},
{
"name": "location-and-asn-absent-are-reported",
"why": "An answer carrying ip and is_vpn alone has no location or asn, so terms on them can never match and both are reported.",
"body": {
"ip": "146.70.116.130",
"is_vpn": true
},
"condition": [
{
"location": {
"country": "AT"
}
},
{
"asn": {
"type": "hosting"
}
}
],
"expect": {
"blocked": false,
"missing": [
"asn",
"location"
]
}
},
{
"name": "bogon-location-is-present-and-empty",
"why": "A bogon's location is synthesized with every key empty, so a country term finds no country and reports nothing missing.",
"bogon": "10.0.0.1",
"condition": {
"location": {
"country": "AT"
}
},
"expect": {
"blocked": false,
"missing": []
}
}
],
"invalidConditions": [
{
"name": "empty-condition",
"why": "Nothing to satisfy means it matches every answer, which is a total outage.",
"condition": {}
},
{
"name": "every-entry-ignored",
"why": "Ignoring false leaves this constraining nothing, so it must be refused rather than silently blocking everybody.",
"condition": {
"is_vpn": false
}
},
{
"name": "empty-nested-object",
"why": "An empty nested object asserts only that the member is in your plan.",
"condition": {
"vpn": {}
}
}
]
},
"oauth": {
"why": "The public OAuth accessor. Arguments use the canonical parameter names; form fields and response members are WIRE names, mapped by each SDK exactly as it maps any other response. mslm:apikey_id and mslm:apikey surface as apikey_id and apikey.",
"endpoints": {
"metadata": {
"method": "GET",
"path": "/.well-known/oauth-authorization-server"
},
"deviceAuthorization": {
"method": "POST",
"path": "/oauth/device_authorization"
},
"token": {
"method": "POST",
"path": "/oauth/token"
},
"revoke": {
"method": "POST",
"path": "/oauth/revoke"
}
},
"noCredential": {
"why": "Build the client WITH this key, call every OAuth operation, and assert none of it leaves: no Authorization or X-Api-Key header, no apikey query parameter, and the key string nowhere in the URL, a header or the body.",
"apiKey": "vd_test_SECRET_must_not_leave",
"forbiddenHeaders": [
"authorization",
"x-api-key"
],
"forbiddenQuery": [
"apikey"
]
},
"forms": {
"why": "Decode the received body as application/x-www-form-urlencoded (+ is a space) and compare the field map EXACTLY: same keys, no extras, same values. Values carrying + & = % / space and non-ASCII catch an encoder that leaves any of them raw. Field order is not significant.",
"contentType": "application/x-www-form-urlencoded",
"cases": [
{
"name": "device-authorization-client-only",
"operation": "deviceAuthorization",
"endpoint": "deviceAuthorization",
"args": {
"clientId": "vpndetection-cli"
},
"fields": {
"client_id": "vpndetection-cli"
}
},
{
"name": "device-authorization-scope-and-resource",
"operation": "deviceAuthorization",
"endpoint": "deviceAuthorization",
"args": {
"clientId": "vpndetection-cli",
"scope": "account.read apikeys.read apikeys.reveal",
"resource": "https://api.vpndetection.io/"
},
"fields": {
"client_id": "vpndetection-cli",
"scope": "account.read apikeys.read apikeys.reveal",
"resource": "https://api.vpndetection.io/"
}
},
{
"name": "exchange-device-code",
"operation": "exchangeDeviceCode",
"endpoint": "token",
"args": {
"clientId": "vpndetection-cli",
"deviceCode": "mo_dc_Zq7+/="
},
"fields": {
"grant_type": "urn:ietf:params:oauth:grant-type:device_code",
"device_code": "mo_dc_Zq7+/=",
"client_id": "vpndetection-cli"
}
},
{
"name": "exchange-refresh-token",
"operation": "exchangeRefreshToken",
"endpoint": "token",
"args": {
"clientId": "vpndetection-cli",
"refreshToken": "mo_rt_a+b c&d=é"
},
"fields": {
"grant_type": "refresh_token",
"refresh_token": "mo_rt_a+b c&d=é",
"client_id": "vpndetection-cli"
}
},
{
"name": "revoke",
"operation": "revoke",
"endpoint": "revoke",
"args": {
"clientId": "vpndetection-cli",
"token": "mo_rt_x+y/z="
},
"fields": {
"token": "mo_rt_x+y/z=",
"client_id": "vpndetection-cli"
}
}
]
},
"responses": {
"why": "Decoding a 2xx. Every listed member is present with that value; every absent one is the language's absence, never an empty string or zero. An empty scope string is PRESENT.",
"metadata": [
{
"name": "production-document",
"status": 200,
"body": {
"issuer": "https://api.vpndetection.io",
"authorization_endpoint": "https://api.vpndetection.io/oauth/authorize",
"token_endpoint": "https://api.vpndetection.io/oauth/token",
"device_authorization_endpoint": "https://api.vpndetection.io/oauth/device_authorization",
"revocation_endpoint": "https://api.vpndetection.io/oauth/revoke",
"scopes_supported": [
"account.read",
"apikeys.read",
"apikeys.reveal",
"apikeys.manage",
"org.read",
"billing.read"
],
"response_types_supported": [
"code"
],
"grant_types_supported": [
"authorization_code",
"refresh_token",
"urn:ietf:params:oauth:grant-type:device_code"
],
"token_endpoint_auth_methods_supported": [
"none"
],
"code_challenge_methods_supported": [
"S256"
],
"authorization_response_iss_parameter_supported": true,
"client_id_metadata_document_supported": true,
"registration_endpoint": "https://api.vpndetection.io/oauth/register",
"service_documentation": "https://api.vpndetection.io/"
},
"expect": {
"present": {
"issuer": "https://api.vpndetection.io",
"authorization_endpoint": "https://api.vpndetection.io/oauth/authorize",
"token_endpoint": "https://api.vpndetection.io/oauth/token",
"device_authorization_endpoint": "https://api.vpndetection.io/oauth/device_authorization",
"revocation_endpoint": "https://api.vpndetection.io/oauth/revoke",
"scopes_supported": [
"account.read",
"apikeys.read",
"apikeys.reveal",
"apikeys.manage",
"org.read",
"billing.read"
],
"response_types_supported": [
"code"
],
"grant_types_supported": [
"authorization_code",
"refresh_token",
"urn:ietf:params:oauth:grant-type:device_code"
],
"token_endpoint_auth_methods_supported": [
"none"
],
"code_challenge_methods_supported": [
"S256"
],
"authorization_response_iss_parameter_supported": true,
"client_id_metadata_document_supported": true,
"registration_endpoint": "https://api.vpndetection.io/oauth/register",
"service_documentation": "https://api.vpndetection.io/"
},
"absent": []
}
}
],
"deviceAuthorization": [
{
"name": "with-complete-uri",
"status": 200,
"body": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 5
},
"expect": {
"present": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 5
},
"absent": []
}
},
{
"name": "without-complete-uri",
"status": 200,
"body": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"expires_in": 900,
"interval": 5
},
"expect": {
"present": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"expires_in": 900,
"interval": 5
},
"absent": [
"verification_uri_complete"
]
}
}
],
"token": [
{
"name": "device-grant-hands-over-the-key",
"status": 200,
"body": {
"access_token": "mo_at_7Qm1",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_9Xc4",
"scope": "account.read apikeys.read apikeys.reveal",
"mslm:apikey_id": "3f1c2a4e-8d7b-4c6a-9e2f-5b0d1c7a8e93",
"mslm:apikey": "vd_live_example_not_a_real_key"
},
"expect": {
"present": {
"access_token": "mo_at_7Qm1",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_9Xc4",
"scope": "account.read apikeys.read apikeys.reveal",
"apikey_id": "3f1c2a4e-8d7b-4c6a-9e2f-5b0d1c7a8e93",
"apikey": "vd_live_example_not_a_real_key"
},
"absent": []
}
},
{
"name": "refresh-names-the-key-never-reveals-it",
"status": 200,
"body": {
"access_token": "mo_at_7Qm1",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_9Xc4",
"scope": "account.read apikeys.read apikeys.reveal",
"mslm:apikey_id": "3f1c2a4e-8d7b-4c6a-9e2f-5b0d1c7a8e93"
},
"expect": {
"present": {
"access_token": "mo_at_7Qm1",
"apikey_id": "3f1c2a4e-8d7b-4c6a-9e2f-5b0d1c7a8e93"
},
"absent": [
"apikey"
]
}
},
{
"name": "no-key-picked",
"status": 200,
"body": {
"access_token": "mo_at_poll",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_poll",
"scope": "account.read"
},
"expect": {
"present": {
"access_token": "mo_at_poll",
"refresh_token": "mo_rt_poll",
"scope": "account.read"
},
"absent": [
"apikey_id",
"apikey"
]
}
},
{
"name": "rfc-minimum",
"status": 200,
"body": {
"access_token": "mo_at_min",
"token_type": "Bearer",
"expires_in": 3600
},
"expect": {
"present": {
"access_token": "mo_at_min",
"token_type": "Bearer",
"expires_in": 3600
},
"absent": [
"refresh_token",
"scope",
"apikey_id",
"apikey"
]
}
},
{
"name": "empty-scope-is-present",
"status": 200,
"body": {
"access_token": "mo_at_s",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_s",
"scope": ""
},
"expect": {
"present": {
"scope": ""
},
"absent": [
"apikey_id",
"apikey"
]
}
},
{
"name": "unknown-members-ignored",
"status": 200,
"body": {
"access_token": "mo_at_u",
"token_type": "Bearer",
"expires_in": 3600,
"id_token": "x",
"mslm:future": {
"nested": [
1,
2
]
}
},
"expect": {
"present": {
"access_token": "mo_at_u"
},
"absent": [
"apikey_id",
"apikey"
]
}
}
],
"revoke": [
{
"name": "empty-object",
"status": 200,
"body": {}
},
{
"name": "empty-body",
"status": 200,
"rawBody": ""
},
{
"name": "unexpected-members",
"status": 200,
"body": {
"revoked": true
}
}
]
},
"errors": {
"why": "How a non-2xx from ANY OAuth operation is reported. type: oauth is the OAuth error, accessDenied and expiredToken its two distinct subtypes, client the SDK's ordinary error. Only a 4xx whose body is a JSON object with a string error member is an OAuth error; message is asserted only for OAuth errors. rawBody is sent verbatim, body as JSON.",
"cases": [
{
"name": "authorization-pending",
"status": 400,
"body": {
"error": "authorization_pending"
},
"expect": {
"type": "oauth",
"errorCode": "authorization_pending",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "authorization_pending"
}
},
{
"name": "slow-down-from-the-rate-limiter",
"status": 400,
"body": {
"error": "slow_down",
"error_description": "too many requests; slow down and try again"
},
"expect": {
"type": "oauth",
"errorCode": "slow_down",
"errorDescription": "too many requests; slow down and try again",
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "slow_down: too many requests; slow down and try again"
}
},
{
"name": "access-denied",
"status": 400,
"body": {
"error": "access_denied"
},
"expect": {
"type": "accessDenied",
"errorCode": "access_denied",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "access_denied"
}
},
{
"name": "expired-token",
"status": 400,
"body": {
"error": "expired_token"
},
"expect": {
"type": "expiredToken",
"errorCode": "expired_token",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "expired_token"
}
},
{
"name": "invalid-grant-with-description",
"status": 400,
"body": {
"error": "invalid_grant",
"error_description": "PKCE verification failed"
},
"expect": {
"type": "oauth",
"errorCode": "invalid_grant",
"errorDescription": "PKCE verification failed",
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "invalid_grant: PKCE verification failed"
}
},
{
"name": "invalid-client-is-a-401",
"status": 401,
"body": {
"error": "invalid_client",
"error_description": "unknown client"
},
"expect": {
"type": "oauth",
"errorCode": "invalid_client",
"errorDescription": "unknown client",
"status": 401,
"kind": "unauthorized",
"retryable": false,
"message": "invalid_client: unknown client"
}
},
{
"name": "unknown-code-is-still-oauth",
"status": 400,
"body": {
"error": "some_future_code"
},
"expect": {
"type": "oauth",
"errorCode": "some_future_code",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "some_future_code"
}
},
{
"name": "non-string-description-dropped",
"status": 400,
"body": {
"error": "invalid_request",
"error_description": 7
},
"expect": {
"type": "oauth",
"errorCode": "invalid_request",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "invalid_request"
}
},
{
"name": "extra-members-ignored",
"status": 400,
"body": {
"error": "invalid_request",
"error_uri": "https://example.com/e",
"state": "x"
},
"expect": {
"type": "oauth",
"errorCode": "invalid_request",
"errorDescription": null,
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "invalid_request"
}
},
{
"name": "rc-envelope-500-is-not-oauth",
"status": 500,
"body": {
"rc": "ERROR"
},
"expect": {
"type": "client",
"status": 500,
"kind": "server_error",
"retryable": true
}
},
{
"name": "rfc-body-on-a-5xx-is-not-oauth",
"status": 500,
"body": {
"error": "server_error"
},
"expect": {
"type": "client",
"status": 500,
"kind": "server_error",
"retryable": true
}
},
{
"name": "html-gateway-error",
"status": 502,
"rawBody": "<html><body>Bad Gateway</body></html>",
"expect": {
"type": "client",
"status": 502,
"kind": "server_error",
"retryable": true
}
},
{
"name": "json-400-without-error-member",
"status": 400,
"body": {
"message": "nope"
},
"expect": {
"type": "client",
"status": 400,
"kind": "bad_request",
"retryable": false
}
},
{
"name": "error-member-not-a-string",
"status": 400,
"body": {
"error": 42
},
"expect": {
"type": "client",
"status": 400,
"kind": "bad_request",
"retryable": false
}
},
{
"name": "plain-text-404",
"status": 404,
"rawBody": "Not Found",
"expect": {
"type": "client",
"status": 404,
"kind": "bad_request",
"retryable": false
}
}
]
},
"retries": {
"why": "Which operations retry, with the client left at its default retries. A retried operation takes a second attempt after a 5xx; a token exchange is issued exactly ONCE; an OAuth error is never retried by any operation.",
"cases": [
{
"name": "metadata-retries-a-5xx",
"operation": "metadata",
"args": {},
"responses": [
{
"status": 503,
"rawBody": ""
},
{
"status": 200,
"body": {
"issuer": "https://api.vpndetection.io",
"authorization_endpoint": "https://api.vpndetection.io/oauth/authorize",
"token_endpoint": "https://api.vpndetection.io/oauth/token",
"device_authorization_endpoint": "https://api.vpndetection.io/oauth/device_authorization",
"revocation_endpoint": "https://api.vpndetection.io/oauth/revoke",
"scopes_supported": [
"account.read",
"apikeys.read",
"apikeys.reveal",
"apikeys.manage",
"org.read",
"billing.read"
],
"response_types_supported": [
"code"
],
"grant_types_supported": [
"authorization_code",
"refresh_token",
"urn:ietf:params:oauth:grant-type:device_code"
],
"token_endpoint_auth_methods_supported": [
"none"
],
"code_challenge_methods_supported": [
"S256"
],
"authorization_response_iss_parameter_supported": true,
"client_id_metadata_document_supported": true,
"registration_endpoint": "https://api.vpndetection.io/oauth/register",
"service_documentation": "https://api.vpndetection.io/"
}
}
],
"expect": {
"requests": 2,
"outcome": "ok"
}
},
{
"name": "device-authorization-retries-a-5xx",
"operation": "deviceAuthorization",
"args": {
"clientId": "vpndetection-cli"
},
"responses": [
{
"status": 503,
"rawBody": ""
},
{
"status": 200,
"body": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 5
}
}
],
"expect": {
"requests": 2,
"outcome": "ok"
}
},
{
"name": "revoke-retries-a-5xx",
"operation": "revoke",
"args": {
"clientId": "vpndetection-cli",
"token": "mo_rt_r"
},
"responses": [
{
"status": 503,
"rawBody": ""
},
{
"status": 200,
"body": {}
}
],
"expect": {
"requests": 2,
"outcome": "ok"
}
},
{
"name": "device-code-exchange-is-issued-once",
"operation": "exchangeDeviceCode",
"args": {
"clientId": "vpndetection-cli",
"deviceCode": "mo_dc_r"
},
"responses": [
{
"status": 503,
"rawBody": ""
}
],
"expect": {
"requests": 1,
"outcome": "client",
"kind": "server_error"
}
},
{
"name": "refresh-is-issued-once",
"operation": "exchangeRefreshToken",
"args": {
"clientId": "vpndetection-cli",
"refreshToken": "mo_rt_r"
},
"responses": [
{
"status": 503,
"rawBody": ""
}
],
"expect": {
"requests": 1,
"outcome": "client",
"kind": "server_error"
}
},
{
"name": "oauth-error-is-never-retried",
"operation": "deviceAuthorization",
"args": {
"clientId": "vpndetection-cli"
},
"responses": [
{
"status": 400,
"body": {
"error": "slow_down",
"error_description": "too many requests; slow down and try again"
}
}
],
"expect": {
"requests": 1,
"outcome": "oauth",
"errorCode": "slow_down"
}
}
]
},
"poll": {
"why": "pollDeviceToken against a stub answering responses in order. waits is every delay the helper takes, in seconds, INCLUDING the one before a local deadline check. With a seam replacing BOTH the sleep and the monotonic clock, assert waits exactly. On the real clock assert each gap (call to first request, then request to request) is at least its wait - 0.05 s and under wait + 1 s, and that the call settles no sooner than sum(waits) - 0.05 s after it began. requests is exact, and every request is the exchangeDeviceCode form for clientId and device.device_code.",
"cases": [
{
"name": "pending-then-token",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"responses": [
{
"status": 400,
"body": {
"error": "authorization_pending"
}
},
{
"status": 200,
"body": {
"access_token": "mo_at_poll",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_poll",
"scope": "account.read"
}
}
],
"expect": {
"outcome": "token",
"requests": 2,
"waits": [
1,
1
],
"token": {
"access_token": "mo_at_poll"
}
}
},
{
"name": "slow-down-widens-for-good",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"why": "+5 s per slow_down, cumulative, and kept through a pending answer. Catches a widening that lasts one tick, one that does not accumulate, and one a pending answer resets.",
"responses": [
{
"status": 400,
"body": {
"error": "slow_down"
}
},
{
"status": 400,
"body": {
"error": "authorization_pending"
}
},
{
"status": 400,
"body": {
"error": "slow_down",
"error_description": "too many requests; slow down and try again"
}
},
{
"status": 200,
"body": {
"access_token": "mo_at_poll",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_poll",
"scope": "account.read"
}
}
],
"expect": {
"outcome": "token",
"requests": 4,
"waits": [
1,
6,
6,
11
]
}
},
{
"name": "access-denied-ends-the-poll",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"responses": [
{
"status": 400,
"body": {
"error": "authorization_pending"
}
},
{
"status": 400,
"body": {
"error": "access_denied"
}
}
],
"expect": {
"outcome": "accessDenied",
"requests": 2,
"waits": [
1,
1
],
"status": 400
}
},
{
"name": "server-expired-token-ends-the-poll",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"responses": [
{
"status": 400,
"body": {
"error": "expired_token"
}
}
],
"expect": {
"outcome": "expiredToken",
"requests": 1,
"waits": [
1
],
"status": 400
}
},
{
"name": "deadline-passes-locally",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 2,
"interval": 1
},
"why": "expires_in is counted from the call. The raised error has no status, which is how a local expiry is told apart.",
"responses": [
{
"status": 400,
"body": {
"error": "authorization_pending"
}
}
],
"expect": {
"outcome": "expiredToken",
"requests": 1,
"waits": [
1,
1
],
"status": null
}
},
{
"name": "other-oauth-error-ends-the-poll",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"responses": [
{
"status": 400,
"body": {
"error": "invalid_grant",
"error_description": "device code was not issued to this client"
}
}
],
"expect": {
"outcome": "oauth",
"errorCode": "invalid_grant",
"requests": 1,
"waits": [
1
]
}
},
{
"name": "server-error-ends-the-poll-unretried",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 1
},
"responses": [
{
"status": 400,
"body": {
"error": "authorization_pending"
}
},
{
"status": 503,
"rawBody": ""
}
],
"expect": {
"outcome": "client",
"kind": "server_error",
"retryable": true,
"requests": 2,
"waits": [
1,
1
]
}
},
{
"name": "interval-below-one-means-five",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 900,
"interval": 0
},
"responses": [
{
"status": 200,
"body": {
"access_token": "mo_at_poll",
"token_type": "Bearer",
"expires_in": 3600,
"refresh_token": "mo_rt_poll",
"scope": "account.read"
}
}
],
"expect": {
"outcome": "token",
"requests": 1,
"waits": [
5
]
}
},
{
"name": "interval-past-the-deadline-sleeps-only-to-it",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 2,
"interval": 2147483647
},
"why": "A sleep that would end past the local deadline ends at it, and the local expiry follows with no request sent: the outcome the full sleep reaches anyway, without asking the runtime for a sleep it may not hold (.NET's Task.Delay throws past ~49.7 days). 2147483647 is the largest interval every SDK's type holds.",
"responses": [
{
"status": 400,
"body": {
"error": "authorization_pending"
}
}
],
"expect": {
"outcome": "expiredToken",
"requests": 0,
"waits": [
2
],
"status": null
}
},
{
"name": "slow-down-past-the-deadline-sleeps-only-to-it",
"clientId": "vpndetection-cli",
"device": {
"device_code": "mo_dc_poll",
"user_code": "BCDF-GHJK",
"verification_uri": "https://app.vpndetection.io/device",
"verification_uri_complete": "https://app.vpndetection.io/device?user_code=BCDF-GHJK",
"expires_in": 8,
"interval": 1
},
"why": "The cut applies to every sleep, a widened one included: 1, then 6 after the first slow_down, then only the 1 s left of the 8 rather than 11.",
"responses": [
{
"status": 400,
"body": {
"error": "slow_down"
}
},
{
"status": 400,
"body": {
"error": "slow_down"
}
}
],
"expect": {
"outcome": "expiredToken",
"requests": 2,
"waits": [
1,
6,
1
],
"status": null
}
}
]
},
"deferred": {
"why": "Vectors for authorizationUrl, exchangeAuthorizationCode, createPkce and pkceChallenge, which ship only once the server can complete the authorization-code flow. A device-flow runner never reads this key; nothing outside it names a deferred operation. emit.mjs still verifies these vectors so they are right when the methods ship.",
"pkce": {
"why": "RFC 7636 Appendix B. A generated verifier is 32 CSPRNG bytes as unpadded base64url.",
"verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk",
"challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
"method": "S256",
"generatedVerifierPattern": "^[A-Za-z0-9_-]{43}$"
},
"authorizationUrl": [
{
"name": "required-only",
"why": "The five parameters every URL carries, in this order, and nothing else.",
"baseUrl": "https://api.vpndetection.io",
"clientId": "example-client",
"redirectUri": "http://127.0.0.1:8765/callback",
"codeChallenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
"expect": "https://api.vpndetection.io/oauth/authorize?response_type=code&client_id=example-client&redirect_uri=http%3A%2F%2F127.0.0.1%3A8765%2Fcallback&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256"
},
{
"name": "every-option-reserved-characters-trailing-slash",
"why": "One trailing slash on the base URL is dropped. Only A-Z a-z 0-9 - . _ ~ stay literal: a space is %20 never +, a literal + is %2B, and encodeURIComponent alone leaves ! * ' ( ) unencoded, which this pins.",
"baseUrl": "https://api.vpndetection.io/",
"clientId": "https://client.example/oauth/metadata.json",
"redirectUri": "https://app.example/cb?next=/a b&x=1+2#frag",
"codeChallenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM",
"scope": "account.read apikeys.read",
"state": "s/t+a=t&e~!*'()é",
"resource": "https://api.vpndetection.io/",
"expect": "https://api.vpndetection.io/oauth/authorize?response_type=code&client_id=https%3A%2F%2Fclient.example%2Foauth%2Fmetadata.json&redirect_uri=https%3A%2F%2Fapp.example%2Fcb%3Fnext%3D%2Fa%20b%26x%3D1%2B2%23frag&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=account.read%20apikeys.read&state=s%2Ft%2Ba%3Dt%26e~%21%2A%27%28%29%C3%A9&resource=https%3A%2F%2Fapi.vpndetection.io%2F"
}
],
"forms": [
{
"name": "exchange-authorization-code",
"operation": "exchangeAuthorizationCode",
"endpoint": "token",
"args": {
"clientId": "example-client",
"code": "mo_ac_q+w&e=r%t",
"codeVerifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk",
"redirectUri": "http://127.0.0.1:8765/callback?a=1&b=two words"
},
"fields": {
"grant_type": "authorization_code",
"code": "mo_ac_q+w&e=r%t",
"redirect_uri": "http://127.0.0.1:8765/callback?a=1&b=two words",
"client_id": "example-client",
"code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk"
}
}
],
"retries": [
{
"name": "authorization-code-exchange-is-issued-once",
"operation": "exchangeAuthorizationCode",
"args": {
"clientId": "example-client",
"code": "mo_ac_r",
"codeVerifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk",
"redirectUri": "http://127.0.0.1:8765/callback"
},
"responses": [
{
"status": 503,
"rawBody": ""
}
],
"expect": {
"requests": 1,
"outcome": "client",
"kind": "server_error"
}
}
]
},
"register": {
"why": "Vectors for register, RFC 7591 dynamic client registration: the client_id a client gets when it cannot serve a Client ID Metadata Document. The one OAuth request whose body is JSON. Nothing is stored until a person approves the client, so registering again consumes nothing and the operation takes the client's retries. noCredential holds for it as for every OAuth operation. A runner that has not shipped register never reads this key; nothing outside it names the operation.",
"endpoint": {
"method": "POST",
"path": "/oauth/register"
},
"contentType": "application/json",
"bodies": {
"why": "Decode the received body as JSON and compare it EXACTLY: same members, no extras, same values, redirect_uris in the order given. An optional argument given empty is left out, never sent empty. Values carrying a quote, a backslash, + & = % / space and non-ASCII catch an encoder that builds JSON by hand.",
"cases": [
{
"name": "redirect-uris-only",
"args": {
"redirectUris": [
"http://127.0.0.1:8765/callback"
]
},
"body": {
"redirect_uris": [
"http://127.0.0.1:8765/callback"
]
}
},
{
"name": "several-uris-and-a-name",
"args": {
"redirectUris": [
"https://app.example.com/oauth/callback",
"http://localhost/cb?a=1&b=two words%2B"
],
"clientName": "Exämple \"CLI\" + tools/\\ 中"
},
"body": {
"redirect_uris": [
"https://app.example.com/oauth/callback",
"http://localhost/cb?a=1&b=two words%2B"
],
"client_name": "Exämple \"CLI\" + tools/\\ 中"
}
},
{
"name": "an-empty-client-name-is-left-out",
"args": {
"redirectUris": [
"http://[::1]/cb"
],
"clientName": ""
},
"body": {
"redirect_uris": [
"http://[::1]/cb"
]
}
}
]
},
"refusals": {
"why": "Refused before anything is sent, the way the SDK refuses a required value given empty in the code flow's methods: no request reaches the server. Only emptiness is checked here; which URIs are acceptable is the server's to say (invalid_redirect_uri).",
"cases": [
{
"name": "no-redirect-uris",
"args": {
"redirectUris": []
}
},
{
"name": "an-empty-redirect-uri",
"args": {
"redirectUris": [
"http://127.0.0.1:8765/callback",
""
]
}
}
]
},
"responses": {
"why": "Decoding a 2xx, as the other responses sections do: every listed member present with that value, every absent one the language's absence. client_id_issued_at is Unix seconds, so a 32-bit integer holds it only until 2038.",
"cases": [
{
"name": "as-served",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"token_endpoint_auth_method": "none",
"scope": "apikeys.use"
},
"expect": {
"present": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"token_endpoint_auth_method": "none",
"scope": "apikeys.use"
},
"absent": []
}
},
{
"name": "rfc-minimum",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
},
"expect": {
"present": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
},
"absent": [
"grant_types",
"response_types",
"scope"
]
}
},
{
"name": "issued-after-2038",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 4102444800,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
},
"expect": {
"present": {
"client_id_issued_at": 4102444800
},
"absent": [
"scope"
]
}
},
{
"name": "unknown-members-ignored",
"status": 200,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"token_endpoint_auth_method": "none",
"scope": "apikeys.use",
"client_secret_expires_at": 0,
"software_id": "example"
},
"expect": {
"present": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"scope": "apikeys.use"
},
"absent": []
}
}
]
},
"unreadable": {
"why": "A 2xx register cannot read as its answer, with the client's retries at 0: the SDK's ordinary error (type client), kind server_error, carrying the status, after one request. Never a raw parser error, and never an empty registration. A member of the wrong type is unreadable at any depth, inside redirect_uris included, and an optional one too.",
"cases": [
{
"name": "html-page",
"status": 200,
"rawBody": "<html><body>Sign in</body></html>"
},
{
"name": "empty-body",
"status": 201,
"rawBody": ""
},
{
"name": "cut-off",
"status": 201,
"rawBody": "{\"client_id\":\"dcr_x\",\"client_id_is"
},
{
"name": "an-array",
"status": 201,
"body": []
},
{
"name": "empty-object",
"status": 201,
"body": {}
},
{
"name": "no-client-id",
"status": 201,
"body": {
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
}
},
{
"name": "no-client-id-issued-at",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
}
},
{
"name": "no-client-name",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
}
},
{
"name": "no-redirect-uris",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"token_endpoint_auth_method": "none"
}
},
{
"name": "no-token-endpoint-auth-method",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
]
}
},
{
"name": "issued-at-as-a-string",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": "1792304178",
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none"
}
},
{
"name": "redirect-uris-not-a-list",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": "http://127.0.0.1:8765/callback",
"token_endpoint_auth_method": "none"
}
},
{
"name": "a-redirect-uri-not-a-string",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
1
],
"token_endpoint_auth_method": "none"
}
},
{
"name": "scope-not-a-string",
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"token_endpoint_auth_method": "none",
"scope": [
"apikeys.use"
]
}
}
]
},
"retries": [
{
"name": "register-retries-a-5xx",
"args": {
"redirectUris": [
"http://127.0.0.1:8765/callback"
]
},
"responses": [
{
"status": 503,
"rawBody": ""
},
{
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"token_endpoint_auth_method": "none",
"scope": "apikeys.use"
}
}
],
"expect": {
"requests": 2,
"outcome": "ok"
}
},
{
"name": "register-retries-an-unreadable-2xx",
"args": {
"redirectUris": [
"http://127.0.0.1:8765/callback"
]
},
"responses": [
{
"status": 200,
"rawBody": "<html><body>Sign in</body></html>"
},
{
"status": 201,
"body": {
"client_id": "dcr_eyJ2IjoxLCJhIjoiaW50ZXJuZXRkYXRhIiwibiI6IkV4YW1wbGUgQ0xJIn0.bm90LWEtcmVhbC1tYWMtZXhhbXBsZS1vbmx5LTAxMjM",
"client_id_issued_at": 1792304178,
"client_name": "Example CLI",
"redirect_uris": [
"http://127.0.0.1:8765/callback"
],
"grant_types": [
"authorization_code",
"refresh_token"
],
"response_types": [
"code"
],
"token_endpoint_auth_method": "none",
"scope": "apikeys.use"
}
}
],
"expect": {
"requests": 2,
"outcome": "ok"
}
},
{
"name": "register-oauth-error-is-never-retried",
"args": {
"redirectUris": [
"http://127.0.0.1:8765/callback"
]
},
"responses": [
{
"status": 400,
"body": {
"error": "slow_down",
"error_description": "too many requests; slow down and try again"
}
}
],
"expect": {
"requests": 1,
"outcome": "oauth",
"errorCode": "slow_down"
}
}
],
"errors": [
{
"name": "a-refused-redirect-uri",
"status": 400,
"body": {
"error": "invalid_redirect_uri",
"error_description": "redirect_uris[0] must be https, or http on a loopback address"
},
"expect": {
"type": "oauth",
"errorCode": "invalid_redirect_uri",
"errorDescription": "redirect_uris[0] must be https, or http on a loopback address",
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "invalid_redirect_uri: redirect_uris[0] must be https, or http on a loopback address"
}
},
{
"name": "refused-metadata",
"status": 400,
"body": {
"error": "invalid_client_metadata",
"error_description": "grant_types must include authorization_code"
},
"expect": {
"type": "oauth",
"errorCode": "invalid_client_metadata",
"errorDescription": "grant_types must include authorization_code",
"status": 400,
"kind": "bad_request",
"retryable": false,
"message": "invalid_client_metadata: grant_types must include authorization_code"
}
},
{
"name": "a-server-without-registration",
"status": 404,
"rawBody": "Not Found",
"expect": {
"type": "client",
"status": 404,
"kind": "bad_request",
"retryable": false
}
}
]
}
},
"vocabulary": {
"why": "A closed vocabulary in an ANSWER (a plan's tier, a database's standing and license type, a format, a download's outcome) is the API's to extend. Each case serves a well-formed answer carrying a value no published list holds, and the call must hand that value back as served, a raw string or an unknown case that carries it, and never fail: a binding that refuses it breaks every installed copy of itself the day the API adds a value, and a release cannot reach the copies already installed. A wrong TYPE (a number, a null where the member is required) is still refused, and refusing an unpublished value in a REQUEST before the network is unchanged. Each `expect` key is a path through the answer's wire names, a number indexing a list; each suite reads it through its own typed result.",
"cases": [
{
"name": "entitlement-plan-name",
"why": "The plan's name is what a client shows, and key is what it compares: the free plan's key is free and its name Unlimited. A binding that drops name leaves a client building one from the key, which a renamed plan then gets wrong.",
"call": "myEntitlement",
"answer": {
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
"apikey": {
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
"expires": null,
"allowed_cidrs": []
},
"plan": {
"key": "free",
"name": "Unlimited",
"tier": "free"
},
"usage": {
"requests": 580,
"quota": 5000000,
"hard_limit": null,
"window_start": "2026-11-01T00:00:00Z",
"window_end": "2026-12-01T00:00:00Z"
}
},
"expect": {
"plan.key": "free",
"plan.name": "Unlimited",
"plan.tier": "free"
}
},
{
"name": "entitlement-tier-unknown",
"why": "A plan whose tier no published list holds: the answer reads, and the tier comes back as served.",
"call": "myEntitlement",
"answer": {
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
"apikey": {
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
"expires": null,
"allowed_cidrs": []
},
"plan": {
"key": "data",
"name": "Data",
"tier": "data"
},
"usage": {
"requests": 580,
"quota": 5000000,
"hard_limit": null,
"window_start": "2026-11-01T00:00:00Z",
"window_end": "2026-12-01T00:00:00Z"
}
},
"expect": {
"plan.key": "data",
"plan.name": "Data",
"plan.tier": "data"
}
},
{
"name": "database-standing-unknown",
"why": "A database whose standing no published list holds: the catalog reads, and the standing comes back as served.",
"call": "listDatabases",
"answer": {
"databases": [
{
"base": "vpn_ip_extended",
"name": "VPN IP Extended",
"summary": "Every VPN exit address, with its provider.",
"license_type": "standard",
"starts": "2026-01-01T00:00:00Z",
"expires": null,
"renews_at": null,
"notice_due_at": null,
"in_term": true,
"standing": "suspended",
"open": false,
"versions": [
{
"id": "vpn_ip_extended_v1",
"version": 1,
"formats": [
{
"format": "csvgz",
"bytes": 1024
}
],
"sample_formats": [
"csvgz"
]
}
]
}
]
},
"expect": {
"databases.0.base": "vpn_ip_extended",
"databases.0.standing": "suspended"
}
},
{
"name": "database-license-type-unknown",
"why": "A license type no published list holds: the catalog reads, and the license type comes back as served, never as no license at all.",
"call": "listDatabases",
"answer": {
"databases": [
{
"base": "vpn_ip_extended",
"name": "VPN IP Extended",
"summary": "Every VPN exit address, with its provider.",
"license_type": "oem",
"starts": "2026-01-01T00:00:00Z",
"expires": null,
"renews_at": null,
"notice_due_at": null,
"in_term": true,
"standing": "licensed",
"open": false,
"versions": [
{
"id": "vpn_ip_extended_v1",
"version": 1,
"formats": [
{
"format": "csvgz",
"bytes": 1024
}
],
"sample_formats": [
"csvgz"
]
}
]
}
]
},
"expect": {
"databases.0.base": "vpn_ip_extended",
"databases.0.license_type": "oem"
}
},
{
"name": "database-format-unknown",
"why": "A format no published list holds, in a version's formats and its sample formats: the catalog reads, and each comes back as served. Refusing it in a download REQUEST before the network stays as it is.",
"call": "listDatabases",
"answer": {
"databases": [
{
"base": "vpn_ip_extended",
"name": "VPN IP Extended",
"summary": "Every VPN exit address, with its provider.",
"license_type": "standard",
"starts": "2026-01-01T00:00:00Z",
"expires": null,
"renews_at": null,
"notice_due_at": null,
"in_term": true,
"standing": "licensed",
"open": false,
"versions": [
{
"id": "vpn_ip_extended_v1",
"version": 1,
"formats": [
{
"format": "parquet",
"bytes": 2048
}
],
"sample_formats": [
"parquet"
]
}
]
}
]
},
"expect": {
"databases.0.versions.0.formats.0.format": "parquet",
"databases.0.versions.0.formats.0.bytes": 2048,
"databases.0.versions.0.sample_formats.0": "parquet"
}
},
{
"name": "download-outcome-unknown",
"why": "A download outcome no published list holds: the history reads, and the outcome comes back as served.",
"call": "listDownloads",
"answer": {
"downloads": [
{
"dataset_id": "vpn_ip_extended_v1",
"format": "csvgz",
"outcome": "throttled",
"sample": false,
"open": false,
"bytes": 1024,
"http_status": 302,
"apikey_id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
"client_ip": "8.8.8.8",
"user_agent": "curl/8.14.1",
"created": "2026-11-15T07:00:00Z"
}
]
},
"expect": {
"downloads.0.dataset_id": "vpn_ip_extended_v1",
"downloads.0.outcome": "throttled"
}
}
]
},
"bogons": {
"v4": [
"0.0.0.0/8",
"10.0.0.0/8",
"100.64.0.0/10",
"127.0.0.0/8",
"169.254.0.0/16",
"172.16.0.0/12",
"192.0.0.0/24",
"192.0.2.0/24",
"192.88.99.2/32",
"192.168.0.0/16",
"198.18.0.0/15",
"198.51.100.0/24",
"203.0.113.0/24",
"224.0.0.0/4",
"255.255.255.255/32",
"240.0.0.0/4"
],
"v6": [
"::/128",
"::1/128",
"::ffff:0:0/96",
"::/96",
"64:ff9b::/96",
"64:ff9b:1::/48",
"100::/64",
"100:0:0:1::/64",
"2001:2::/48",
"2001:10::/28",
"2001:db8::/32",
"3fff::/20",
"5f00::/16",
"fc00::/7",
"fe80::/10",
"fec0::/10",
"ff00::/8",
"2002::/24",
"2002:a00::/24",
"2002:6440::/26",
"2002:7f00::/24",
"2002:a9fe::/32",
"2002:ac10::/28",
"2002:c000::/40",
"2002:c000:200::/40",
"2002:c058:6302::/48",
"2002:c0a8::/32",
"2002:c612::/31",
"2002:c633:6400::/40",
"2002:cb00:7100::/40",
"2002:e000::/20",
"2002:ffff:ffff::/48",
"2002:f000::/20",
"2001::/40",
"2001:0:a00::/40",
"2001:0:6440::/42",
"2001:0:7f00::/40",
"2001:0:a9fe::/48",
"2001:0:ac10::/44",
"2001:0:c000::/56",
"2001:0:c000:200::/56",
"2001:0:c058:6302::/64",
"2001:0:c0a8::/48",
"2001:0:c612::/47",
"2001:0:c633:6400::/56",
"2001:0:cb00:7100::/56",
"2001:0:e000::/36",
"2001:0:ffff:ffff::/64",
"2001:0:f000::/36",
"2001:1::/32",
"2001:2::/31",
"2001:4::/30",
"2001:8::/29",
"2001:20::/27",
"2001:40::/26",
"2001:80::/25",
"2001:100::/24",
"::/3",
"4000::/3",
"6000::/3",
"8000::/3",
"a000::/3",
"c000::/3",
"e000::/3"
]
}
}