Skip to content

Get account settings

GET
/settings
curl --request GET \
--url https://api.proxyrequest.com/api/v1/settings \
--header 'Authorization: Bearer <token>'

Returns proxy gateway addresses, account usage totals, referral thresholds, and supported crypto currencies for the authenticated account.

The operation completed successfully.

Media typeapplication/json
object
gateways
required
Array<object>
object
id
required
string format: uuid
name
required
string
region
required
string
hostname
required
string
hostnames
required
Array<string>
port_http
required
integer
port_socks5
required
integer
port_auto
required
integer
port_haproxy
required
integer
spent_total
required
number format: double
orders_total
required
integer
orders_active
required
integer
data_available
required
integer
data_spent
required
integer
referrals
required
object
reward_balance_percentage
required
number format: double
reward_data_percentage
required
number format: double
reward_min_balance
required
number format: double
reward_min_data
required
number format: double
crypto
required
object
currencies
required
Array<string>
Examples
ExampleAccountSettings

Account settings

{
"gateways": [
{
"id": "550e8400-e29b-41d4-a716-446655440020",
"name": "US East",
"region": "us-east",
"hostname": "proxy.thepremiumports.com",
"hostnames": [
"us-east-1.proxy.thepremiumports.com",
"us-east-2.proxy.thepremiumports.com"
],
"port_http": 8000,
"port_socks5": 1080,
"port_auto": 9000,
"port_haproxy": 9000
}
],
"spent_total": 125.5,
"orders_total": 4,
"orders_active": 2,
"data_available": 10737418240,
"data_spent": 2147483648,
"referrals": {
"reward_balance_percentage": 10,
"reward_data_percentage": 5,
"reward_min_balance": 25,
"reward_min_data": 1073741824
},
"crypto": {
"currencies": [
"BTC",
"USDT"
]
}
}

The request is malformed or violates a business rule.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
Exampleexample

Validation error

{
"non_field_errors": [
"The request could not be processed."
],
"translation": "errors.request.invalid"
}

Authentication credentials are missing, expired, or invalid.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleAuthenticationRequired

Authentication required

{
"detail": "Authentication credentials were not provided."
}

The authenticated account cannot perform this operation.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExamplePermissionDenied

Permission denied

{
"detail": "You do not have permission to perform this action."
}

The service could not complete the operation.

Media typeapplication/json

Validation and API error payload. Field names may be added dynamically; field errors are returned as arrays of human-readable messages.

object
detail
string
non_field_errors
Array<string>
translation

Stable translation key suitable for client localisation.

string
key
additional properties
One of:
string
Examples
ExampleInternalServiceError

Internal service error

{
"non_field_errors": [
"Internal server error."
]
}