Geolocations API
Retrieve all available geolocations with country codes and geographic discounts
Geolocations API
Access the complete list of available geolocations. View country names, codes, and any geographic-based discounts configured for each region.
All Locations
Complete country list.
Country Codes
ISO 2 and 3 char codes.
Geo Discounts
Regional pricing.
Endpoint Overview
/graphqlRetrieve all available geolocations including country names, ISO codes, and any geographic discounts applied to each region.
GraphQL Query
query geolocations {
geolocations {
id
name
code
threeCharCode
geoDiscount
}
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"query": "query geolocations { geolocations { id name code threeCharCode geoDiscount } }"
}'Response
{
"data": {
"geolocations": [
{
"id": "1",
"name": "United States",
"code": "US",
"threeCharCode": "USA",
"geoDiscount": 0
},
{
"id": "2",
"name": "United Kingdom",
"code": "GB",
"threeCharCode": "GBR",
"geoDiscount": 0
},
{
"id": "3",
"name": "Germany",
"code": "DE",
"threeCharCode": "DEU",
"geoDiscount": 0
},
{
"id": "4",
"name": "Netherlands",
"code": "NL",
"threeCharCode": "NLD",
"geoDiscount": 0
},
{
"id": "5",
"name": "Iran",
"code": "IR",
"threeCharCode": "IRN",
"geoDiscount": 50
}
]
}
}Response Fields
idID!Unique identifier for the geolocation.
nameString!Full country name.
codeString!ISO 3166-1 alpha-2 country code (2 characters).
threeCharCodeString!ISO 3166-1 alpha-3 country code (3 characters).
geoDiscountInt!Discount percentage for users in this region (0 = no discount).
Use Cases
Location Picker
Build country selection dropdowns.
Server Display
Show server locations to users.
Regional Pricing
Apply geographic discounts.
Analytics
Track usage by region.
Related Endpoints
Geographic Discounts
The geoDiscount field allows for regional pricing adjustments. Users connecting from regions with a non-zero discount will automatically receive reduced pricing.
Find Servers by Location
View VPN servers available in each geolocation.