Skip to content

Quote a static rental selection

POST
/orders/purchase/quote
curl --request POST \
--url https://api.proxyrequest.com/api/v1/orders/purchase/quote \
--header 'Accept-Language: de' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "offer_id": "550e8400-e29b-41d4-a716-446655440001", "term_id": "550e8400-e29b-41d4-a716-446655440001", "quantity": 1, "location": { "country_code": "us", "region_id": "550e8400-e29b-41d4-a716-446655440001", "city_id": "550e8400-e29b-41d4-a716-446655440001" }, "idempotency_key": "idempotency key" }'

Calculate the all-units tier price for a term, quantity and proxy location without reserving inventory. Proxy location is separate from the billing country.

Accept-Language
string
default: en

Preferred language for human-readable API errors. Supported languages: en, ru, uk, de, it, fr, es. Regional language tags and quality weights are accepted; unsupported or omitted values use English.

Examples
de
object
offer_id
string format: uuid
term_id
string format: uuid
quantity
integer
>= 1 <= 10000
location
object
country_code
required
string
>= 2 characters <= 2 characters
region_id
string format: uuid
nullable
city_id
string format: uuid
nullable
idempotency_key
required
string
>= 1 characters <= 128 characters
Examples
Exampleexample

Example request

{
"offer_id": "550e8400-e29b-41d4-a716-446655440001",
"term_id": "550e8400-e29b-41d4-a716-446655440001",
"quantity": 1,
"location": {
"country_code": "us",
"region_id": "550e8400-e29b-41d4-a716-446655440001",
"city_id": "550e8400-e29b-41d4-a716-446655440001"
},
"idempotency_key": "idempotency key"
}

The operation completed successfully.

Media typeapplication/json
object
key
additional properties
Examples
Exampleexample

Example response

{}

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>
key
additional properties
One of:
string
Examples
Exampleexample

Validation error

{
"non_field_errors": [
"The request could not be processed."
]
}
Content-Language
string

Language used for human-readable errors.

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>
key
additional properties
One of:
string
Examples
Exampleexample

Authentication required

{
"detail": "Authentication credentials were not provided."
}
Content-Language
string

Language used for human-readable errors.

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>
key
additional properties
One of:
string
Examples
Exampleexample

Permission denied

{
"detail": "You do not have permission to perform this action."
}
Content-Language
string

Language used for human-readable errors.