VPN protocol dataset exports

Free API & downloads: 24-hour access

Get access here before using the API or downloading a dataset. Your key and download links expire after 24 hours. Return to this page and press the button to get new access; it does not renew automatically.

Checking access…

Protected by Google reCAPTCHA. Google’s Privacy Policy and Terms of Service apply.

For permanent access, tell us your name, email and intended use. Requests are reviewed individually.

Already saved files are not revoked. A configuration may stop working earlier if its third-party server changes. Individual OpenVPN checks still use their existing single-use download token.

Other protocol exports

Download complete metadata snapshots for every protocol. All four formats use the same checked records as API v1. Empty catalogs produce valid empty files. Configurations are available through the links in each record.

Add &country=US for a country subset. Cache with ETag; compare X-Dataset-Version and verify bytes with X-Checksum-SHA256. JSON includes lifecycle metadata. Protocol API documentation.

OpenVPN snapshot

Fields and examples

Schema 1.1 keeps source claims separate from PublicVPNList checks. Key provenance fields are source_reported_speed_mbps, source_reported_ping_ms, checker_measured_tunnel_rtt_ms, checker_measured_throughput_mbps, checker_region, measurement_method, measured_at, measurement_quality and measurement_status. Unknown values are null, never synthetic zeroes.

curl --fail --compressed \
  https://publicvpnlist.com/exports/openvpn-latest.json \
  -o openvpn-latest.json
sha256sum -c checksums.txt

For conditional updates, use If-None-Match with API v1 or compare dataset_version in the manifest before downloading a new file.

Configuration bundle status

The stable ZIP currently contains only README, manifest and checksums, with 0 .ovpn files. Raw profiles stay excluded until source-by-source redistribution rights and static safety checks are confirmed. The archive name remains stable for future compatible publication.

f8ea08c5db46d3da07404625b91ca2a7dae6be28b7dbe9e5890b3bad106ca96a

Country files and versions

Country files are generated only where at least five eligible records exist. Example: US JSON, US CSV and a policy-only US ZIP with 0 profiles pending license review.

Current latest version: 20261028T224113Z-d6cab6061fef. Latest immutable archive: 20261028T164615Z-bb6362d6dacd. Versioned files use /exports/versions/{dataset_version}/; archives are created at most four times daily and retained for at least 90 days.

Verify downloads with sha256sum -c checksums.txt. Clients should compare the manifest’s generated_at/expires_at and fetch again after next_update_at from API dataset metadata.

License, attribution and takedown

Dataset metadata and measurements are separated from third-party configurations. See data terms, source attribution and measurement methodology. Operators can request correction or removal through contacts.

The official GitHub repository publishes API schemas, examples and validation tooling. Endpoint datasets, ZIP bundles and raw .ovpn profiles remain excluded from GitHub until their source-by-source redistribution rights and a separate dataset license are confirmed.