beta

API

Every page is built from these endpoints. Send an API key as Authorization: Bearer vpndb_…; create one under Account.

This page

GET /api/v1/meta

curl -s -H 'Authorization: Bearer vpndb_EXAMPLE_NOT_A_REAL_KEY' \
  '/api/v1/meta'
Open raw JSON in a new tab ↗
All endpoints
GET /api/v1/ip/{ip}Who operates an address
GET /api/v1/ip/{ip}/historyEvery week of an address
GET /api/v1/prefix/{cidr}Any range, and who is inside it
GET /api/v1/prefix/{cidr}/addressesEvery address of a prefix, in a window
GET /api/v1/prefix/{cidr}/timelineHow a prefix was probed, day by day
GET /api/v1/asn/{asn}A network and its providers
GET /api/v1/asn/{asn}/networksEvery prefix of a network
GET /api/v1/org/{id}A company and all its networks
GET /api/v1/org/{id}/networksEvery prefix of a company
GET /api/v1/country/{cc}The infrastructure located in a country
GET /api/v1/countriesEvery country at a glance
GET /api/v1/service/{tag}A provider's profile
GET /api/v1/service/{tag}/networksEvery network a provider exits from
GET /api/v1/servicesEvery provider at a glance
POST /api/v1/bulkMany addresses at once
GET /api/v1/searchResolve free text
GET /api/v1/suggestSuggestions as you type
GET /api/v1/metaThe dataset
GET /api/v1/openapi.yamlThis specification
GET /api/v1/sourcesWhere the data comes from
API documentationOpenAPI specification
Sign in
Limits
Known limitations
What the dataset cannot tell you, and why — stated up front rather than discovered mid-investigation.
Collected here in addition to appearing beside the features they affect. An unanticipated limitation is more costly than a documented one.
LimitationConsequence
IPv6 is not collected by probingA miss means “not collected”, not “clean”. Some external lists cover it and are named where they answer.
Network-wide views rest on the enriched snapshotASN, prefix and provider breakdowns count only the addresses it reaches; a single lookup is not limited by it
December 2024 and January 2025 are missingTrends spanning them are not comparable
August 2025 is nearly emptySame
Three providers are no longer probedperfectprivacy, astrillvpn, hotspotshield show history only
Mullvad probing has broken downThree addresses in 30 days against hundreds historically
Five collectors, one contributing 21.6 %The corpus is geographically skewed