Skip to content

Read a rental purchase

GET
/static/purchases/{id}
curl --request GET \
--url https://api.proxyrequest.com/api/v1/static/purchases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Accept-Language: de' \
--header 'Authorization: Bearer <token>'

Inspect the authenticated customer’s reservation, immutable pricing snapshot, invoice and fulfillment status. Paid rentals start after listener acknowledgement.

id
required
string format: uuid
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

The operation completed successfully.

Media typeapplication/json
object
id
required
string format: uuid
status
required
  • reserved - reserved * provisioning - provisioning * fulfilled - fulfilled * expired - expired * paid_unfulfilled - paid_unfulfilled
string
Allowed values: reserved provisioning fulfilled expired paid_unfulfilled
snapshot
required
object
location
object
country_code
required
string
>= 2 characters <= 2 characters
region_id
string format: uuid
nullable
city_id
string format: uuid
nullable
tier_id
string format: uuid
min_quantity
integer
unit_price_cents
integer
version
required
integer
term_id
required
string format: uuid
offer_id
string format: uuid
endpoint_ids
Array<string>
duration_kind
required
  • hours - hours * calendar_months - calendar_months
string
Allowed values: hours calendar_months
duration_value
required
integer
quantity
required
integer
price_cents
required
integer
currency
required
string
country_code
required
string
allocation_mode
required
string
network_class
required
string
hold_hours
required
integer
commission_rate
required
string
commission_type
required
string
reserved_until
required
string format: date-time
invoice_id
required
string format: uuid
nullable
order_id
required
string format: uuid
nullable
Examples
Exampleexample

Example response

{
"id": "550e8400-e29b-41d4-a716-446655440001",
"status": "reserved",
"snapshot": {
"location": {
"country_code": "us",
"region_id": "550e8400-e29b-41d4-a716-446655440001",
"city_id": "550e8400-e29b-41d4-a716-446655440001"
},
"tier_id": "550e8400-e29b-41d4-a716-446655440001",
"min_quantity": 1,
"unit_price_cents": 1,
"version": 1,
"term_id": "550e8400-e29b-41d4-a716-446655440001",
"offer_id": "550e8400-e29b-41d4-a716-446655440001",
"endpoint_ids": [
"550e8400-e29b-41d4-a716-446655440001"
],
"duration_kind": "hours",
"duration_value": 1,
"quantity": 1,
"price_cents": 1,
"currency": "USD",
"country_code": "us",
"allocation_mode": "allocation mode",
"network_class": "network class",
"hold_hours": 1,
"commission_rate": "commission rate",
"commission_type": "commission type"
},
"reserved_until": "2026-07-01T12:30:00Z",
"invoice_id": "550e8400-e29b-41d4-a716-446655440004",
"order_id": "550e8400-e29b-41d4-a716-446655440003"
}

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.

The requested resource does not exist in the current account scope.

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

Resource not found

{
"detail": "Not found."
}
Content-Language
string

Language used for human-readable errors.