Query static proxy inventory in batches

POST /open-api/v1/static/inventory

Base URL: https://api.ipbunker.online/gin.

Authentication

Send your key in the X-API-Key request header.

JSON request body

Field	Type	Required	Constraints	Meaning
static_type	string	Yes	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	Static proxy product type.
region_codes	string[]	Yes	—	Distinct region codes, returned in the same order as requested.
duration_days	integer	No	format: int32	Duration in days. Use a positive integer supported by the active price catalog.

Request example

curl --request POST \
  --url 'https://api.ipbunker.online/gin/open-api/v1/static/inventory' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "static_type": "ISP",
  "region_codes": [
    "US_CA",
    "JP_TK"
  ]
}'

Success response data

Responses use code, msg, data, and next. HTTP 200 can also contain a nonzero business error code; check code first.

Field	Type	Required	Constraints	Meaning
data	object[]	No	—	Data.
data[].static_type	string	No	enum: ISP, ISP_NATIVE, ISP_CARRIER_NATIVE	Static proxy product type.
data[].region_code	string	No	—	Region code returned by the regions endpoint.
data[].available_quantity	integer	No	format: int32; minimum: 0	Available units; zero can also indicate an upstream inventory lookup failure.
data[].in_stock	boolean	No	—	In stock.
data[].checked_time	string	No	format: date-time	Inventory check or snapshot time, GMT+8 ISO 8601.

Endpoint notes

This endpoint accepts POST with a JSON list of regions. It returns one result per requested region in order. Zero inventory may also mean the upstream inventory lookup failed. It does not reserve stock. The old GET request is unsupported.

Related conventions

Request conventions · Response structure · Error codes · API reference index