VPNDetectionVPNDetection

API

Download a database whenever you choose, with an API key.

The Database API downloads any database your organization holds a license for, with an API key carrying the db.download scope. It suits a job that runs on your own schedule, and it's what the CLI and the client libraries call:

curl -L -o vpn_ip_v1.mmdb "https://api.vpndetection.io/api/v1/database/download?id=vpn_ip_v1&format=mmdb&apikey=$KEY"

Before downloading, Metadata says when the current build was made, so a daily job can skip a database that hasn't changed, and Checksums gives each file's SHA-256 to check one once it lands. Download history lists every download your organization made, refusals included. Which credential each endpoint takes is on Authentication.

To have new builds come to you instead, announce them to a webhook, whose payload carries these same download links, or have them written to your own storage: AWS S3, Google Cloud Storage, Azure Blob Storage or SFTP.