Ipqualityscore

the ipqualityscore connector offers a variety of different risk analysis apis designed to proactively prevent fraud™ for your company, website, or app prerequisites this section shows you how to create your account and obtain the private key needed for the swimlane connector account setup get started with ipqualityscore by following this link https //www ipqualityscore com/?r=314077 how to obtain an api token create an account using the link above if you have an existing account, log in and skip to step 4 select get free api key on the landing page this will prompt the registration follow the registration steps to create your account once you arrive at the dashboard page, select api docs located in the middle of the screen select proxy and vpn detection api and scroll down until you see the private key copy and paste the private key into the swimlane asset capabilities this connector integrates with email validation, proxy/vpn, request, and fraudulent posting apis the following are just some of the example use cases bot detection low quality users ip reputation account takeover geo filtering high risk behavior lead generation & user data verification report fraudulent ips, email addresses and previous lookups spam traps list cleaning asset setup this section provides instructions for obtaining information for the swimlane asset action setup retrieve previous requests you can use any standard datetime format, or put in a relative time, on start date or stop date inputs relative datetime format for the current time now any other time (+/ )(integer) (milliseconds|seconds|minutes|days|weeks|months|years) examples now 1 months +3 days 123 seconds limitations currently, swimlane does not support the device tracking api or transaction api if this is something crucial to you, please contact swimlane support notes detailed instructions for how to use each api/connector action are available in the documentation below please read thoroughly to fully understand the use cases that can be set up from within your environment documentation https //www ipqualityscore com/documentation/email validation/overview https //www ipqualityscore com/documentation/proxy detection/overview https //www ipqualityscore com/documentation/fraud reporting/overview https //www ipqualityscore com/documentation/request list/overview this connector was last tested against product version 10 3 0 configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required ipqs key api key string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions email validation detect fraudulent email addresses, spam traps, and honeypots endpoint url api/json/email method get input argument name type required description parameters email string required parameters for the email validation action input example {"parameters" {"email" "soar\@swimlane com"}} output parameter type description status code number http status code of the response reason string response reason phrase message string response message success boolean whether the operation was successful valid boolean unique identifier disposable boolean output field disposable smtp score number score value overall score number score value first name string name of the resource generic boolean output field generic common boolean output field common dns valid boolean unique identifier honeypot boolean output field honeypot deliverability string output field deliverability frequent complainer boolean output field frequent complainer spam trap score string score value catch all boolean output field catch all timed out boolean output field timed out suspect boolean output field suspect recent abuse boolean output field recent abuse fraud score number score value suggested domain string output field suggested domain leaked boolean output field leaked domain age object output field domain age domain age human string output field domain age human output example {"status code" 200,"response headers" {"date" "thu, 08 dec 2022 20 51 28 gmt","content type" "application/json; charset=utf 8","transfer encoding" "chunked","connection" "keep alive","cf cache status" "dynamic","report to" "{\\"endpoints\\" \[{\\"url\\" \\"https \\\\/\\\\/a nel cloudflare com\\\\/report\\\\/v3?s=kqdvfjyjpurxp ","nel" "{\\"success fraction\\" 0,\\"report to\\" \\"cf nel\\",\\"max age\\" 604800}","server" "cloudflare","cf ray" "776861110e35a62f gru","content encoding" "gzip","alt svc" "h3=\\" 443\\"; m proxy and vpn detection provides over 25 data points for risk analysis, geo location, and ip intelligence endpoint url api/json/ip method get input argument name type required description parameters ip string required parameters for the proxy and vpn detection action parameters strictness string optional parameters for the proxy and vpn detection action parameters mobile string optional parameters for the proxy and vpn detection action parameters fast string optional parameters for the proxy and vpn detection action parameters transaction strictness string optional parameters for the proxy and vpn detection action parameters user agent string optional parameters for the proxy and vpn detection action parameters user language string optional parameters for the proxy and vpn detection action parameters allow public access points string optional parameters for the proxy and vpn detection action parameters lighter penalties string optional parameters for the proxy and vpn detection action input example {"parameters" {"ip" "1 1 1 1","strictness" "2","mobile" "","fast" "","transaction strictness" "2","user agent" "mozilla/5 0 (\<system information>) \<platform> (\<platform details>) \<extensions>","user language" "fr ch, fr;q=0 9, en;q=0 8","allow public access points" "","lighter penalties" ""}} output parameter type description status code number http status code of the response reason string response reason phrase success boolean whether the operation was successful message string response message fraud score number score value country code string output field country code region string output field region city string output field city isp string output field isp asn number output field asn operating system string output field operating system browser string output field browser organization string output field organization is crawler boolean output field is crawler timezone string output field timezone mobile boolean output field mobile host string output field host proxy boolean output field proxy vpn boolean output field vpn tor boolean output field tor active vpn boolean output field active vpn active tor boolean output field active tor device brand string output field device brand device model string output field device model recent abuse boolean output field recent abuse output example {"status code" 200,"response headers" {"date" "thu, 08 dec 2022 21 00 41 gmt","content type" "application/json; charset=utf 8","transfer encoding" "chunked","connection" "keep alive","cf cache status" "dynamic","report to" "{\\"endpoints\\" \[{\\"url\\" \\"https \\\\/\\\\/a nel cloudflare com\\\\/report\\\\/v3?s=wk3u8ojkeyw73 ","nel" "{\\"success fraction\\" 0,\\"report to\\" \\"cf nel\\",\\"max age\\" 604800}","server" "cloudflare","cf ray" "77686e8d2fc1a4cf gru","content encoding" "gzip","alt svc" "h3=\\" 443\\"; m report fraudulent addresses this data trains your account's machine learning algorithms that identify high risk behavior among your users, clicks, and transactions endpoint url api/json/report/{{private key}} method get input argument name type required description path parameters private key string required parameters for the report fraudulent addresses action parameters ip string optional parameters for the report fraudulent addresses action parameters billing first name string optional parameters for the report fraudulent addresses action parameters billing last name string optional parameters for the report fraudulent addresses action parameters billing company string optional parameters for the report fraudulent addresses action parameters billing country string optional parameters for the report fraudulent addresses action parameters billing address 1 string optional parameters for the report fraudulent addresses action parameters billing address 2 string optional parameters for the report fraudulent addresses action parameters billing city string optional parameters for the report fraudulent addresses action parameters billing region string optional parameters for the report fraudulent addresses action parameters billing postcode string optional parameters for the report fraudulent addresses action parameters billing email string optional parameters for the report fraudulent addresses action parameters billing phone string optional parameters for the report fraudulent addresses action parameters shipping first name string optional parameters for the report fraudulent addresses action parameters shipping last name string optional parameters for the report fraudulent addresses action parameters shipping company string optional parameters for the report fraudulent addresses action parameters shipping country string optional parameters for the report fraudulent addresses action parameters shipping address 1 string optional parameters for the report fraudulent addresses action parameters shipping address 2 string optional parameters for the report fraudulent addresses action parameters shipping city string optional parameters for the report fraudulent addresses action parameters shipping region string optional parameters for the report fraudulent addresses action parameters shipping postcode string optional parameters for the report fraudulent addresses action parameters shipping email string optional parameters for the report fraudulent addresses action parameters shipping phone string optional parameters for the report fraudulent addresses action parameters username string optional parameters for the report fraudulent addresses action input example {"parameters" {"ip" "1 1 1 1","billing first name" "swimlane","billing last name" "soar","billing company" "swimlane","billing country" "us","billing address 1" "123 swimlane drive","billing address 2" "unit 3","billing city" "chicago","billing region" "il","billing postcode" "12345","billing email" "swimlane\@gmail com","billing phone" "1234567890","shipping first name" "swimlane","shipping last name" "swimlane","shipping company" "swimlane","shipping country" "us","shipping address 1" "123 swimlane drive","shipping address 2" "unit 3","shipping city" "chicago","shipping region" "il","shipping postcode" "12345","shipping email" "swimlane\@gmail com","shipping phone" "0123456789","username" "user or user\@swimlane com","password hash" "password","credit card bin" "765987","credit card hash" "5fd924625f6ab16a19cc9807c7c506ae1813490e4ba675f843d5a10e0baacdb8","credit card expiration year" "22","credit card expiration month" "05","avs code" "123","cvv code" "123","order amount" "123","order quantity" "50","recurring" "","recurring times" "12"},"path parameters" {"private key" "tutzlaflgn6nsrpebaprzpid28nbsqdw"}} output parameter type description status code number http status code of the response reason string response reason phrase success boolean whether the operation was successful message string response message request id string unique identifier output example {"status code" 200,"response headers" {"date" "thu, 08 dec 2022 21 55 36 gmt","content type" "application/json; charset=utf 8","transfer encoding" "chunked","connection" "keep alive","cf cache status" "dynamic","report to" "{\\"endpoints\\" \[{\\"url\\" \\"https \\\\/\\\\/a nel cloudflare com\\\\/report\\\\/v3?s=evza%2f4skd43 ","nel" "{\\"success fraction\\" 0,\\"report to\\" \\"cf nel\\",\\"max age\\" 604800}","server" "cloudflare","cf ray" "7768befc4beca52c gru","content encoding" "gzip","alt svc" "h3=\\" 443\\"; m retrieve previous requests allows you to retrieve previous proxy detection api, email validation api and device fingerprinting technology requests based on the date they occurred endpoint url api/json/requests method get input argument name type required description parameters ip address string optional parameters for the retrieve previous requests action parameters start date string required parameters for the retrieve previous requests action parameters stop date string optional parameters for the retrieve previous requests action parameters tracker id string optional parameters for the retrieve previous requests action parameters limit string optional parameters for the retrieve previous requests action parameters type string optional parameters for the retrieve previous requests action parameters page string optional parameters for the retrieve previous requests action parameters device id string optional parameters for the retrieve previous requests action input example {"parameters" {"ip address" "8 8 8 8","start date" "2020 01 01 00 00 00","stop date" "2023 01 01 00 00 00","tracker id" "123","limit" "25","type" "email","page" "2","device id" "323"}} output parameter type description status code number http status code of the response reason string response reason phrase success boolean whether the operation was successful message string response message request id string unique identifier output example {"status code" 200,"response headers" {"date" "thu, 08 dec 2022 21 45 37 gmt","content type" "application/json; charset=utf 8","transfer encoding" "chunked","connection" "keep alive","cf cache status" "dynamic","report to" "{\\"endpoints\\" \[{\\"url\\" \\"https \\\\/\\\\/a nel cloudflare com\\\\/report\\\\/v3?s=svmrvroa39ewu ","nel" "{\\"success fraction\\" 0,\\"report to\\" \\"cf nel\\",\\"max age\\" 604800}","server" "cloudflare","cf ray" "7768b0620d4da511 gru","content encoding" "gzip","alt svc" "h3=\\" 443\\"; m response headers header description example alt svc http response header alt svc h3=" 443 "; ma=86400, h3 29=" 443 "; ma=86400 cf cache status http response header cf cache status dynamic cf ray http response header cf ray 7768befc4beca52c gru connection http response header connection keep alive content encoding http response header content encoding gzip content type the media type of the resource application/json; charset=utf 8 date the date and time at which the message was originated thu, 08 dec 2022 21 00 41 gmt nel http response header nel {"success fraction" 0 ,"report to" "cf nel","max age" 604800 } report to http response header report to {"endpoints" \[{"url" " https //a nel cloudflare com/report/v3?s=evza%2f4skd43dpozlvm88xgxdlpjplznt7d9p24y5hun4xgl09pkyoctyygdzqkh5aaq9acd3x%2fpgrtxdd7n27catlcdkgxnjqurrbnmom13bndvqnzjzhmv4dmvy%2b6tqjabszcg30hu%3d"}],"group" "cf nel","max age " 604800 } server information about the software used by the origin server cloudflare transfer encoding http response header transfer encoding chunked