VPN Servers API

openapi: 3.1.0
info:
  title: NordVPN Public Catalog Servers API
  version: '1.0'
  description: Minimal OpenAPI for the public NordVPN API providing server listings, recommendations, server load statistics, country and group catalogs, and supported VPN technologies.
  x-generated-from: https://sleeplessbeastie.eu/2019/02/18/how-to-use-public-nordvpn-api/
  x-generated-by: claude-crawl-2026-05-08
servers:
- url: https://api.nordvpn.com
  description: NordVPN public API
tags:
- name: Servers
paths:
  /server:
    get:
      tags:
      - Servers
      summary: Retrieve all VPN servers (legacy endpoint)
      responses:
        '200':
          description: Server list
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
  /v1/servers:
    get:
      tags:
      - Servers
      summary: Get servers with pagination and filter support
      parameters:
      - name: limit
        in: query
        schema:
          type: integer
      - name: offset
        in: query
        schema:
          type: integer
      - name: filters[country_id]
        in: query
        schema:
          type: integer
      - name: filters[servers_groups][identifier]
        in: query
        schema:
          type: string
      - name: filters[servers_technologies][identifier]
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Server list
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
  /v1/servers/recommendations:
    get:
      tags:
      - Servers
      summary: Get recommended servers for the current client
      parameters:
      - name: limit
        in: query
        schema:
          type: integer
      - name: filters[country_id]
        in: query
        schema:
          type: integer
      - name: filters[servers_groups][identifier]
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Recommended servers
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object