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. |