Skip to content

Price and shipping for one catalog product

GET
/catalog/products/{product_id}/pricing
product_id
required

Catalog product id (products.id)

string
/^[1-9]\d*$/
Example
34
delivery_country
required

ISO 3166-1 alpha-2 delivery country code (e.g. FR). Filters catalog by available_countries; cart line items must use a country allowed for the catalog product.

string
Example
FR
currency
required

ISO 4217 alpha-3 currency code for the price row to return

string
Example
EUR
acquisition_mode
required

LEASING vs one-time purchase (BUY). For catalog pricing, LEASING selects monthly lease; BUY selects purchase price.

string
Allowed values: LEASING BUY
Example
LEASING
keyboard_layout

Required when the catalog product has a keyboard or is a keyboard product; same enum as cart keyboard_layout and device characteristics.

string
Allowed values: FRENCH_AZERTY SPANISH_QWERTY ITALIAN_QWERTY INTERNATIONAL_ENGLISH_QWERTY GERMAN_QWERTZ PORTUGUESE_QWERTY ENGLISH_QWERTY SWISS_QWERTZ AMERICAN_ENGLISH_QWERTY CANADIAN_ENGLISH_QWERTY DUTCH_QWERTY
Example
FRENCH_AZERTY

Shipping bounds and a single price amount for the requested currency and acquisition_mode (LEASING vs BUY)

object
data
required
object
min_shipping
required
number
nullable
max_shipping
required
number
nullable
amount
required
number

Validation or business rule error

Any of:
object
error
required
string

Resource not found

object
error
required
string
Allowed values: COMPANY_NOT_FOUND COUNTRY_NOT_FOUND DELIVERY_COUNTRY_NOT_FOUND PRODUCT_NOT_FOUND PRODUCT_PRICING_UNAVAILABLE

Internal server error

object
error
required
string
Allowed values: INTERNAL_ERROR