Skip to content

Price and shipping for one catalog product

GET
/catalog/products/{product_id}/pricing
curl --request GET \
--url 'https://api.fleet.co/platform/v1/catalog/products/34/pricing?delivery_country=FR&currency=EUR&acquisition_mode=LEASING&keyboard_layout=FRENCH_AZERTY' \
--header 'Authorization: Bearer <token>'
product_id
required

Catalog product id

string
/^[1-9]\d*$/

Example

34
delivery_country
required

ISO 3166-1 alpha-2 delivery country code (e.g. FR). Cart line items must use a country where the catalog product is available.

string

Example

FR
currency
required

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

string

Example

EUR
acquisition_mode
required

LEASING: monthly lease. BUY: one-time purchase.

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 SWEDISH_QWERTY NORWEGIAN_QWERTY DANISH_QWERTY FINNISH_QWERTY OTHER

Example

FRENCH_AZERTY

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

Media typeapplication/json
object
data
required
object
min_shipping
required
number
nullable
max_shipping
required
number
nullable
amount
required

Price in the requested currency: the monthly rent for LEASING, the one-time price for BUY

number
is_cto
required
boolean

Example generated

{
"data": {
"min_shipping": 1,
"max_shipping": 1,
"amount": 1,
"is_cto": true
}
}

Validation or business rule error

Media typeapplication/json
Any of:
object
message
required

Every validation failure, comma-separated

string
type
required
string
Allowed values: validation_error
error
required
string
Allowed values: validation_error

Example

{
"message": "Required, must be an ISO 3166-1 alpha-2 country code",
"type": "validation_error",
"error": "validation_error"
}

Missing, invalid, or revoked API key

Media typetext/plain
string

Example

Unauthorized

Resource not found

Media typeapplication/json
object
error
required
string
Allowed values: COMPANY_NOT_FOUND COUNTRY_NOT_FOUND DELIVERY_COUNTRY_NOT_FOUND PRODUCT_NOT_FOUND PRODUCT_PRICING_UNAVAILABLE

Example

{
"error": "COMPANY_NOT_FOUND"
}

Rate limit exceeded. The RateLimit-* headers give the limit and the reset time.

Media typetext/plain
string

Example

Too many requests, please try again later.

Unexpected server error

Media typeapplication/json
object
error
required
string
Allowed values: INTERNAL_ERROR

Example

{
"error": "INTERNAL_ERROR"
}

Rate limiting is temporarily unavailable; retry with backoff

Media typeapplication/json
object
message
required
string

Example generated

{
"message": "example"
}