Get a Static Proxy Renewal Quote

Returns the current renewal quote for a set of resources and a uniform renewal duration. This endpoint has no side effects: it does not create an order or charge the wallet.

API Information

Item	Value
Method	POST
Path	/open-api/v1/static/renewal-quotes
Authentication	X-API-Key
Content-Type	application/json
Processing	Synchronous
Side effects	None; does not create an order or charge the wallet

Request Body

Field	Type	Required	Description	Constraint
resource_ids	string[]	Yes	IDs of the static proxy resources to renew	1–500 IDs after trimming whitespace and removing duplicates; every resource must be accessible, currently ACTIVE, and unexpired
duration_days	integer	Yes	Uniform renewal duration for all resources	Only 7, 30, or 90; it must also match one of the resource-type combinations below

All resources in one quote use the same duration_days. The available combinations are:

Resource types	Available duration_days values
All resources are ISP	7, 30
All resources are ISP_NATIVE	7, 30, 90
Both ISP and ISP_NATIVE resources are included	7, 30

If duration_days is not 7, 30, or 90, the endpoint returns 400009. Error 300320 means the resource price does not exist or does not match the requested specification. The actual msg is returned according to X-LANG; if the header is omitted or unsupported, en_US is used.

The request body may contain only the two fields listed above. It does not accept request_no, callback_url, a quoted amount, or any other unlisted field.

Request Example

curl --request POST \
  --url 'https://api-test.puraroute.com/gin/open-api/v1/static/renewal-quotes' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --data '{
    "resource_ids": [
      "1912345678901234567",
      "1912345678901234568"
    ],
    "duration_days": 30
  }'

Response Fields

data contains only the following fields:

Field	Type	Description
order_amount	string	Current total quoted amount, always with four decimal places
currency	string	Always USD

Successful Response Example

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_amount": "16.0000",
    "currency": "USD"
  },
  "next": null
}

The example amount illustrates the field format only and does not represent an actual price.

Quote Validity

A quote does not lock the price. When you call Create a Static Proxy Renewal Order, resource status is checked again and the order amount is calculated using the price at that time. The actual amount may differ from this quote.

Possible Error Codes

code	Description
300001	A resource does not exist, does not belong to the current account, is not accessible, is not ACTIVE, or has expired
300320	The resource price does not exist or does not match the requested specification
400001	Authentication failed
400009	The duration is not 7, 30, or 90, or a request field or another parameter does not meet the requirements
500000	System processing failed and no quote was obtained