alpha

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'

All endpoints

GET /api/v1/ip/{ip}Verdict for one address, with evidence and confidence
GET /api/v1/ip/{ip}/historyEvery week of an address
GET /api/v1/prefix/{cidr}Prefix with the providers inside it
GET /api/v1/prefix/{cidr}/addressesEvery address of a prefix, in a window, filterable
GET /api/v1/prefix/{cidr}/timelineDaily probing of a prefix
GET /api/v1/asn/{asn}Network with its provider distribution
GET /api/v1/asn/{asn}/networksEvery prefix of a network, filterable
GET /api/v1/org/{id}AS organisation as one network, and its ASNs
GET /api/v1/org/{id}/networksEvery prefix of an organisation, filterable
GET /api/v1/country/{cc}Networks and providers located in a country
GET /api/v1/countriesEvery country with known exits, for the map
GET /api/v1/service/{tag}Provider profile
GET /api/v1/service/{tag}/networksEvery network a provider exits from
GET /api/v1/servicesEvery provider, with addresses, prefixes and countries
POST /api/v1/bulkMany addresses at once, with a summary
GET /api/v1/search?q=Resolve free text to an entity
GET /api/v1/suggest?q=Suggestions as you type
GET /api/v1/metaDataset version, counts, coverage
GET /api/v1/sourcesSource provenance and health — administrators
GET /api/v1/openapi.yamlThis API's OpenAPI 3.1 specification
API documentationOpenAPI specification
Sign in

Sign in

VPNDB is not public. Accounts are approved by an administrator.

No account? Request access