VPNDetectionVPNDetection

List

GET
/api/v1/database/list

Every database this organization may SEE, with where its licence stands. Not just the ones you hold: a customer with one grant should be able to tell what else is published without asking. standing is the difference - licensed, expired, or unlicensed for one never bought.

Authorization

apikey<token>

?apikey=<key>. Convenient in a browser; prefer a header elsewhere.

In: query

Response Body

application/json

application/json

curl -X GET "https://api.vpndetection.io/api/v1/database/list"
{
  "databases": [
    {
      "base": "vpn_ip",
      "name": "VPN IP",
      "summary": "string",
      "license_type": "evaluation",
      "starts": "2019-08-24T14:15:22Z",
      "expires": "2019-08-24T14:15:22Z",
      "renews_at": "2019-08-24T14:15:22Z",
      "notice_due_at": "2019-08-24T14:15:22Z",
      "in_term": true,
      "standing": "expired",
      "versions": [
        {
          "id": "vpn_ip_v1",
          "version": 1,
          "summary": "string",
          "formats": [
            {
              "format": "csvgz",
              "bytes": 0
            }
          ],
          "sample_formats": [
            "csvgz"
          ]
        }
      ]
    }
  ]
}
{
  "rc": "string"
}

Lookup your own address GET

Answers what is known about the address this request came from, which is the same answer `GET /{ip}` gives for that address: the plan behind the presented key decides which fields come back, and the request counts against the same allowance. The address is the one our edge observed, so a request through a proxy or a VPN reports the exit it left through rather than the machine that made it. That is usually the point of asking.

Download GET

Answers `302` with a time-limited URL pointing straight at object storage. Follow the redirect; the link authorizes the START of a transfer, so one already running is not interrupted when it lapses.