Calculate order

POST https://geonix.com/personal/api/v1/{apiKey}/order/calc

This endpoint calculates the cost of an order based on the specified proxy configurations, which you can obtain from the reference list. It is designed to provide you with an estimate before finalizing the purchase, aiding in your planning and budgeting for proxy needs.

Headers

Name

Value

Content-Type

application/json

Path Parameters

Name

Type

Description

apiKey*

string

API key to authorize requests

Body parameters

Name

Type

For Proxy Type

Description

coupon

string

All

Optional promotional code for discounts.

countryId*

integer

IPV4, IPV6, ISP, Mobile

Country ID for the proxy location.

periodId*

string

All

Duration for proxy rental, e.g., "30d" for 30 days.

quantity*

integer

IPV4, IPV6, ISP, Mobile

Number of proxies required.

authorization

string

IPV4, IPV6, ISP, Mobile

IP address for authorization (optional).

targetSectionId

integer

IPV4, ISP, Resident

Section ID for specific proxy targets (optional).

targetId

integer

IPV4, ISP, Resident

ID of the target website or service, 0 for custom.

customTargetName

string

IPV4, ISP, IPV6*,

Resident

Name of the custom target, used when targetId is 0.

protocol

string

IPV6, potentially others

Proxy protocol (HTTPS/SOCKS5).

operatorId*

string

Mobile

Operator ID for mobile proxies.

rotationId*

integer

Mobile

Rotation settings for mobile proxies.

tarifId*

integer

Resident

Tariff ID for resident proxies.

Request examples

curl -X 'POST' \
  'https://geonix.com/personal/api/v1/YOUR_API_KEY_HERE/order/calc' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "coupon": "OZGCNK_1",
  "countryId": 3350393,
  "periodId": "30d",
  "quantity": 5,
  "authorization": "127.0.0.1",
  "targetSectionId": 99,
  "targetId": 0,
  "customTargetName": "Another target"
}'

<?php

$url = 'https://geonix.com/personal/api/v1/YOUR_API_KEY_HERE/order/calc';
$data = array(
    'coupon' => 'OZGCNK_1',
    'countryId' => 3350393,
    'periodId' => '30d',
    'quantity' => 5,
    'authorization' => '127.0.0.1',
    'targetSectionId' => 99,
    'targetId' => 0,
    'customTargetName' => 'Another target'
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($payload)
));

$result = curl_exec($ch);

curl_close($ch);

echo $result;
?>

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class CalcOrderExample {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://geonix.com/personal/api/v1/YOUR_API_KEY_HERE/order/calc");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("accept", "application/json");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);

            String input = "{\"coupon\": \"OZGCNK_1\",\"countryId\": 3350393,\"periodId\": \"30d\",\"quantity\": 5,\"authorization\": \"127.0.0.1\",\"targetSectionId\": 99,\"targetId\": 0,\"customTargetName\": \"Another target\"}";

            try (OutputStream os = conn.getOutputStream()) {
                byte[] inputBytes = input.getBytes("utf-8");
                os.write(inputBytes, 0, inputBytes.length);
            }

            BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String output;
            while ((output = br.readLine()) != null) {
                System.out.println(output);
            }

            conn.disconnect();

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Response examples

If you receive a "warning" in the response, please fix the issue mentioned before making your order.

{
  "status": "success",
  "data": {
    "price": 1.8,
    "warning": "Insufficient funds. Total $4.38. Not enough $4.62",
    "balance": 4.38,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0
  },
  "errors": []
}

PreviousCreate order NextReference list

Last updated 6 months ago