Skip to content

Models

airvpn.api.status.models

Continent

Represents aggregate VPN status for a continent.

Attributes:

Name Type Description
public_name

The continent's display name.

server_best

The recommended server for this continent.

bw

Bandwidth currently in use across the continent, in Mbit/s.

bw_max

Maximum bandwidth available across the continent, in Mbit/s.

users

Number of users currently connected in this continent.

servers

Number of servers available in this continent.

currentload

Current load as a percentage.

ip_v4_in1

First IPv4 hostname for incoming connections.

ip_v4_in2

Second IPv4 hostname for incoming connections.

ip_v4_in3

Third IPv4 hostname for incoming connections.

ip_v4_in4

Fourth IPv4 hostname for incoming connections.

ip_v6_in1

First IPv6 hostname for incoming connections.

ip_v6_in2

Second IPv6 hostname for incoming connections.

ip_v6_in3

Third IPv6 hostname for incoming connections.

ip_v6_in4

Fourth IPv6 hostname for incoming connections.

health

Aggregate health status (ok, warning, or error). A continent in error status does not accept connections.

warning

Reason for a non-ok health status. Only present when health is warning or error; otherwise None.

Country

Represents aggregate VPN status for a country.

Attributes:

Name Type Description
country_name

The country's name.

country_code

ISO country code.

server_best

The recommended server for this country.

bw

Bandwidth currently in use across the country, in Mbit/s.

bw_max

Maximum bandwidth available across the country, in Mbit/s.

users

Number of users currently connected in this country.

servers

Number of servers available in this country.

currentload

Current load as a percentage.

ip_v4_in1

First IPv4 hostname for incoming connections.

ip_v4_in2

Second IPv4 hostname for incoming connections.

ip_v4_in3

Third IPv4 hostname for incoming connections.

ip_v4_in4

Fourth IPv4 hostname for incoming connections.

ip_v6_in1

First IPv6 hostname for incoming connections.

ip_v6_in2

Second IPv6 hostname for incoming connections.

ip_v6_in3

Third IPv6 hostname for incoming connections.

ip_v6_in4

Fourth IPv6 hostname for incoming connections.

health

Aggregate health status (ok, warning, or error). A country in error status does not accept connections.

warning

Reason for a non-ok health status. Only present when health is warning or error; otherwise None.

Planet

Represents aggregate VPN status for the whole planet (global stats).

Attributes:

Name Type Description
public_name

The planet's display name.

server_best

The recommended server globally.

bw

Bandwidth currently in use globally, in Mbit/s.

bw_max

Maximum bandwidth available globally, in Mbit/s.

users

Number of users currently connected globally.

servers

Number of servers available globally.

currentload

Current load as a percentage.

ip_v4_in1

First IPv4 hostname for incoming connections.

ip_v4_in2

Second IPv4 hostname for incoming connections.

ip_v4_in3

Third IPv4 hostname for incoming connections.

ip_v4_in4

Fourth IPv4 hostname for incoming connections.

ip_v6_in1

First IPv6 hostname for incoming connections.

ip_v6_in2

Second IPv6 hostname for incoming connections.

ip_v6_in3

Third IPv6 hostname for incoming connections.

ip_v6_in4

Fourth IPv6 hostname for incoming connections.

health

Aggregate health status (ok, warning, or error). A planet-level entry in error status does not accept connections.

warning

Reason for a non-ok health status. Only present when health is warning or error; otherwise None.

Routing

Represents a routing node's status (no user/IP data attached).

Attributes:

Name Type Description
public_name

The node's public display name.

country_name

Country where the node is located.

country_code

ISO country code of the node's location.

location

Specific city/region of the node.

continent

Continent where the node is located.

bw

Bandwidth currently in use, in Mbit/s.

bw_max

Maximum bandwidth available, in Mbit/s.

currentload

Current load as a percentage.

health

Node health status (ok, warning, or error). A node in error status does not accept connections.

warning

Reason for a non-ok health status. Only present when health is warning or error; otherwise None.

Server

Represents a single VPN server and its current status.

Attributes:

Name Type Description
public_name

The server's public display name.

country_name

Country where the server is located.

country_code

ISO country code of the server's location.

location

Specific city/region of the server.

continent

Continent where the server is located.

bw

Bandwidth currently in use, in Mbit/s.

bw_max

Maximum bandwidth available, in Mbit/s.

users

Number of users currently connected to the server.

currentload

Current load as a percentage.

ip_v4_in1

First IPv4 address for incoming connections.

ip_v4_in2

Second IPv4 address for incoming connections.

ip_v4_in3

Third IPv4 address for incoming connections.

ip_v4_in4

Fourth IPv4 address for incoming connections.

ip_v6_in1

First IPv6 address for incoming connections.

ip_v6_in2

Second IPv6 address for incoming connections.

ip_v6_in3

Third IPv6 address for incoming connections.

ip_v6_in4

Fourth IPv6 address for incoming connections.

health

Server health status (ok, warning, or error). A server in error status does not accept connections.

warning

Reason for a non-ok health status. Only present when health is warning or error; otherwise None.