Renewal quote; no debit

POST/account/api/v1/renewals/quote

Authorization

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Required permission	`read`
Accept	`application/json`
Content-Type	`application/json`

Parameters

Name	Type	Description
`proxy_ids` bodyRequired	`integer[]`	1–1000 unique owned proxy IDs; do not mix product types where a common scope/price is required. Some operations have tighter bounds.
`time_id` bodyRequired	`integer`	Period/GB-plan ID from the matching catalog/options, not a day/GB count.
`promo_code` bodyOptional	`string`	Optional promo, up to 100 bytes. Keep it identical between quote and purchase/renewal. Default: `""`

Request body

Replace YOUR_/FROM_ placeholders with values from the relevant catalog, quote or scope. Examples leave consent false; only approve a real operation intentionally.

request.json

{
    "proxy_ids": [
        "YOUR_PROXY_ID"
    ],
    "time_id": "FROM_RENEWAL_OPTIONS",
    "promo_code": ""
}

Request example

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/renewals/quote'

Examples are not executed on this page. Keep the API key in a server-side environment variable; do not put real keys in URLs or browser code. Prepare request.json for POST examples.

Responses

200Success response

application/json

{
    "ok": true,
    "data": {
        "product_id": 5,
        "currency": "TRY",
        "proxy_ids": [
            12345
        ],
        "quantity": 1,
        "selection_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "time_id": 101,
        "period": "7 days",
        "days": 7,
        "base_total": "10.00",
        "quantity_discount_amount": "0.00",
        "subtotal": "10.00",
        "promotion": {
            "code": "",
            "rate": "0.00",
            "amount": "0.00"
        },
        "total": "10.00",
        "total_minor": 1000,
        "lines": [
            {
                "location_id": 10,
                "country": "Example country",
                "quantity": 1,
                "base_unit_price": "10.0000",
                "unit_price": "10.0000",
                "quantity_discount_rate": "0.00",
                "total_minor": 1000,
                "total": "10.00"
            }
        ],
        "proxies": [
            {
                "id": 12345,
                "location_id": 10,
                "last_service_date": "2030-02-01",
                "projected_last_service_date": "2030-02-08",
                "total": "10.00",
                "total_minor": 1000
            }
        ],
        "discount_scope": "country",
        "timezone": "Europe/Istanbul",
        "estimate_only": true,
        "renewal_available": true,
        "provider_checked": false,
        "calculated_at": "2030-01-01T12:00:00+00:00"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

Response fields and types

Name	Type	Description
`ok`	`boolean`	Success envelope flag; on false inspect error.code.
`data`	`object`	Operation-specific result; examples are illustrative and synthetic.
`data.product_id`	`integer`	Local catalog location or product-type ID.
`data.currency`	`string`	Account transaction currency: TRY or USD.
`data.proxy_ids`	`array`	Proxy IDs in the scope visible to this account.
`data.proxy_ids[]`	`integer`	Proxy IDs in the scope visible to this account.
`data.quantity`	`integer`	Selected or ordered proxy quantity.
`data.selection_hash`	`string`	Freshness fingerprint to copy unchanged to the corresponding write/price confirmation.
`data.time_id`	`integer`	Local period/GB-plan record ID, not a day or GB count.
`data.period`	`string`	Human-readable catalog period name.
`data.days`	`integer`	Plan duration in days, separate from a GB plan’s traffic amount.
`data.base_total`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.quantity_discount_amount`	`string`	Operation-specific quantity discount amount value; preserve its demonstrated type and consult the behavior notes.
`data.subtotal`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.promotion`	`object`	Operation-specific promotion value; preserve its demonstrated type and consult the behavior notes.
`data.promotion.code`	`string`	Operation-specific code value; preserve its demonstrated type and consult the behavior notes.
`data.promotion.rate`	`string`	Operation-specific rate value; preserve its demonstrated type and consult the behavior notes.
`data.promotion.amount`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.total`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.total_minor`	`integer`	Integer minor units: 1000 means 10.00 TRY/USD.
`data.lines`	`array`	Operation-specific lines value; preserve its demonstrated type and consult the behavior notes.
`data.lines[]`	`object`	Operation-specific lines value; preserve its demonstrated type and consult the behavior notes.
`data.lines[].location_id`	`integer`	Local catalog location or product-type ID.
`data.lines[].country`	`string`	Operation-specific country value; preserve its demonstrated type and consult the behavior notes.
`data.lines[].quantity`	`integer`	Selected or ordered proxy quantity.
`data.lines[].base_unit_price`	`string`	Operation-specific base unit price value; preserve its demonstrated type and consult the behavior notes.
`data.lines[].unit_price`	`string`	Operation-specific unit price value; preserve its demonstrated type and consult the behavior notes.
`data.lines[].quantity_discount_rate`	`string`	Operation-specific quantity discount rate value; preserve its demonstrated type and consult the behavior notes.
`data.lines[].total_minor`	`integer`	Integer minor units: 1000 means 10.00 TRY/USD.
`data.lines[].total`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.proxies`	`array`	Operation-specific proxies value; preserve its demonstrated type and consult the behavior notes.
`data.proxies[]`	`object`	Operation-specific proxies value; preserve its demonstrated type and consult the behavior notes.
`data.proxies[].id`	`integer`	Relevant ARNPROXY record ID; use it instead of the upstream internal ID.
`data.proxies[].location_id`	`integer`	Local catalog location or product-type ID.
`data.proxies[].last_service_date`	`string`	Last service day: current, previous or projected by the quote. A projection does not renew.
`data.proxies[].projected_last_service_date`	`string`	Last service day: current, previous or projected by the quote. A projection does not renew.
`data.proxies[].total`	`string`	Money amount; preserve the returned string/integer representation for precision.
`data.proxies[].total_minor`	`integer`	Integer minor units: 1000 means 10.00 TRY/USD.
`data.discount_scope`	`string`	Operation-specific discount scope value; preserve its demonstrated type and consult the behavior notes.
`data.timezone`	`string`	Timezone for related date fields; null means no verified timezone.
`data.estimate_only`	`boolean`	Operation-specific estimate only value; preserve its demonstrated type and consult the behavior notes.
`data.renewal_available`	`boolean`	Availability under the result’s conditions/permissions, not a stock or provider guarantee.
`data.provider_checked`	`boolean`	A price/local result is not by itself a provider or stock guarantee.
`data.calculated_at`	`string`	Timestamp in the API’s returned representation; example dates are synthetic.
`meta`	`object`	Request correlation and data-source metadata.
`meta.request_id`	`string`	This HTTP request’s correlation ID, not an operation key or order ID.
`meta.phase`	`string`	Operation-specific phase value; preserve its demonstrated type and consult the behavior notes.
`meta.source`	`string`	Data source; local records and a live provider lookup are different evidence.

Error response

HTTP 401 · INVALID_API_KEY

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

Authentication and validation may reject a request before execution. Consult the error reference and retain request_id when contacting support. Never send keys or passwords. Errors & limits →

Behavior & important notes

Renewal uses existing website pricing and balance processing. Copy amount, days and selection hash from the same renewal_quote. It does not enable automatic renewal.
Proxies in one renewal request must share the same product type. Quantity discounts are calculated separately using each country’s selected quantity, not the combined country total.