# P11 - List offers for each given product

Call FrequencyRecommended usage: At each product page displayMaximum usage: At each product page displayRead MoreIf the "Price approval" option is activated, read this pagePrice prioritization for Advanced PricingAdvanced Pricing in P11PaginationThis resource supports offset pagination (see documentation)Sort fieldssort field can have the following values:bestPrice (Default) - Sorts by product sku and then by total price, premium information, shop grade (asc by default)bestEvaluation - Sorts by product sku and then by shop grade, total price, premium information (asc by default)LocalizationThis resource supports locale parameter (see documentation)Localized output fields will be highlighted with an icon: 

Endpoint: GET /api/products/offers

## Query parameters:

  - `product_ids` (string)
    List of product's skus separated with comma. Limited to 100 values. One of the two is required product_ids or product_references.

  - `product_references` (string)
    List of the product's identifiers with type (structure: "product_references=<productIdType>|<productId>,<productIdType>|<productId>, ..."). Limited to 100 values.  One of the two is required product_ids or product_references.Example: /api/products/offers?product_references=EAN|3120201243238

  - `offer_state_codes` (string)
    List of offer state codes

  - `all_offers` (boolean)
    If false returns only active offers. If true return all offers.

  - `channel_codes` (string)
    List of the channel codes to filter with, using a comma (,) as a separator. If specified, only offers that can be sold on the specified channel(s) will be returned. If not, offers will be returned regardless of their channels.

  - `all_channels` (boolean)
    If false, filters the offers with the given channel_codes or all shop channels if no channel_codes are given.  If true, filters on all shop channels and ignores the channel_codes.

  - `pricing_channel_code` (string)
    Filter used to pick prices on a specific channel

  - `pricing_customer_organization_id` (string)
    For Customer Pricing users only. Customer identifier code the API will use to return all prices and applicable price for this organization. Ignored if value does not exist.

  - `shipping_zones` (string)
    List of shipping zones. Filter used to pick shipping prices on one or multiple shipping zones

  - `all_shipping_zones` (boolean)
    If false, filters the offers with the given shipping zones.  If true, selects all shop shipping zones and ignores the provided shipping_zones.

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Response 200 fields (application/json):

  - `products` (array)
    List of products information with their offers

  - `products.category_code` (string, required)
    Code of the product category

  - `products.category_label` (string, required)
    Label of the product category

  - `products.measurement` (object)
    Measurement of the product

  - `products.measurement.total_measurement_of_product` (number)
    Product total measurement

  - `products.measurement.unit` (string, required)
    Product measurement unit

  - `products.offers` (array)
    List of offers for the product

  - `products.offers.active` (boolean, required)
    Is the offer active

  - `products.offers.all_prices` (array, required)
    All prices for the offer

For Dropship specifically: the list of purchasing prices of the offer, also referred to as costs or wholesale prices

  - `products.offers.all_prices.context` (object)
    The context is not returned for default prices.

  - `products.offers.all_prices.context.channel_codes` (array)
    The channel codes on which a specific price applies.

  - `products.offers.all_prices.context.customer_group_ids` (array)
    The customer group ids on which a specific price applies.

  - `products.offers.all_prices.context.customer_organization_ids` (array)
    The customer organization ids on which a specific price applies.

  - `products.offers.all_prices.context.end_date` (string)
    The end date of a specific price.

  - `products.offers.all_prices.context.start_date` (string)
    The start date of a specific price.

  - `products.offers.all_prices.discount_end_date` (string)
    End date of the discount, or null if no discount exists or if the discount does not have an end date.

  - `products.offers.all_prices.discount_start_date` (string)
    Start date of the discount, or null if no discount exists or if the discount does not have a start date.

  - `products.offers.all_prices.price` (number, required)
    Price of the offer.

For Dropship specifically: the purchasing price of the offer

If a discount is defined and is currently active (within the validity interval), it represents the unit_discount_price.

In other cases, it represents the unit_origin_price.

  - `products.offers.all_prices.unit_discount_price` (number)
    Discount price for a quantity of one, i.e. the discount price for a quantity of one.

For Dropship specifically: the discount purchasing price for a quantity of one

Set to null if no discount is defined or if no discount price for a quantity of one is defined.

  - `products.offers.all_prices.unit_origin_price` (number, required)
    Original price for a quantity of one, i.e. the price for a quantity of one regardless of the discounts.

For Dropship specifically: the purchasing price for a quantity of one, also referred to as cost or wholesale price

  - `products.offers.all_prices.volume_prices` (array, required)
    Volume prices for each quantity threshold. Returns at least the price for a quantity threshold of one.

  - `products.offers.all_prices.volume_prices.price` (number, required)
    Price of the offer.  If the discount is currently active, it represents the unit discount price. Otherwise it is the original price.

  - `products.offers.all_prices.volume_prices.quantity_threshold` (integer, required)
    Quantity threshold of this price range

  - `products.offers.all_prices.volume_prices.unit_discount_price` (number, required)
    Unit discount price for this quantity threshold

  - `products.offers.all_prices.volume_prices.unit_origin_price` (number, required)
    Unit price for this quantity threshold

  - `products.offers.all_prices.channel_code` (string)
    Single Channel Pricing users: The channel code on which a specific price applies.
    This is the pricing_channel_code supplied as input in the API if prices are defined for this channel.
    If no pricing is defined for this channel, or no pricing_channel_code is supplied, it falls back on the default prices.
    channel_code is set to null for the default prices. Multi Channel Pricing users: returned null.
    Refer to context > channel_codes in order to retrieve the channel codes for which the price apply.

  - `products.offers.allow_quote_requests` (boolean)
    Whether the offer is eligible for quotation

  - `products.offers.applicable_pricing` (object)
    Pricing defined for the offer, including the prices for the selected channel if available

For Dropship specifically: the list of applicable purchasing prices of the offer, also referred to as costs or wholesale prices.

  - `products.offers.currency_iso_code` (string, required)
    The currency of the shop (iso format)
    Enum: "AED", "ARS", "AUD", "BAM", "BGN", "BHD", "BRL", "CAD", "CHF", "CLP", "CNY", "COP", "CZK", "DKK", "EGP", "EUR", "GBP", "GEL", "GTQ", "HKD", "HRK", "HUF", "IDR", "ILS", "INR", "IQD", "JOD", "JPY", "KES", "KRW", "KWD", "LKR", "MAD", "MGA", "MXN", "MYR", "NGN", "NOK", "NZD", "OMR", "PEN", "PHP", "PKR", "PLN", "QAR", "RON", "RSD", "RUB", "SAR", "SEK", "SGD", "TND", "TRY", "THB", "TWD", "UAH", "USD", "UYU", "UZS", "VND", "ZAR"

  - `products.offers.description` (string, required)
    Offer description

  - `products.offers.eco_contributions` (array)
    Eco-contributions of the offer - only available if the operator setting Activate data collection related to circular economy regulations has been enabled.

  - `products.offers.eco_contributions.eco_contribution_amount` (number)
    Amount of the eco-contribution.

  - `products.offers.eco_contributions.epr_category_code` (string, required)
    Extended Producer Responsibility (EPR) category code.
    Enum: "FR-AGROPACK", "FR-ASL", "FR-DASRIPAT", "FR-DBPS", "FR-DDS", "FR-DEA", "FR-DEEE", "FR-DISPMED", "FR-DIY", "FR-EMBM", "FR-GF", "FR-JOUETS", "FR-LUB", "FR-MH", "FR-MNU", "FR-PA", "FR-PAP", "FR-PCHIM", "FR-PMCB", "FR-PNEU", "FR-TABAC", "FR-TLC", "FR-VEHICULE", "FR-VHU", "DE-BATTG", "DE-PACK", "DE-WEEE", "ES-PACK", "ES-GPACK", "ES-WEEE"

  - `products.offers.eco_contributions.producer_id` (string)
    Producer identifier of the eco-contribution.Not present if the producer identifier belongs to the operator.

  - `products.offers.inactivity_reasons` (array)
    Reasons for offers inactivity, mandatory if an offer is inactive
    Enum: "PRODUCT_STATUS_NEW", "PRODUCT_STATUS_INVALID", "PRODUCT_STATUS_REJECTED", "PRODUCT_STATUS_UNAUTHORIZED_TO_SELL", "PRODUCT_STATUS_PENDING", "PRODUCT_STATUS_SYNCHRO_ERROR", "PRODUCT_DISABLED", "SHOP_NOT_OPEN", "ZERO_QUANTITY", "NO_MIN_SHIPPING_RATE", "NOT_IN_AVAILABILITY_PERIOD", "NO_CHANNEL_ON_SHOP", "SHOP_CURRENCY_DISABLED", "AVAILABLE_QUANTITY_LESS_THAN_MIN_ORDER_QUANTITY", "AVAILABLE_QUANTITY_LESS_THAN_PACKAGE_QUANTITY", "NO_ACTIVE_PRICE"

  - `products.offers.is_professional` (boolean, required)
    Whether or not the shop is professional

  - `products.offers.leadtime_to_ship` (integer, required)
    Offer's lead time to ship value. If this value has been set to 0, value is returned as 1 (unless platform's default lead time to ship value is also 0). If no lead time to ship was specified for the offer, platform's default value is returned.

  - `products.offers.min_shipping_price` (number, required)
    Unit price of the minimum shipping rate

  - `products.offers.min_shipping_price_additional` (number, required)
    Additional unit price associated to the minimum shipping rate

  - `products.offers.min_shipping_type` (string, required)
    Code of the shipping type associated to the minimum shipping rate

  - `products.offers.min_shipping_zone` (string, required)
    Code of the shipping zone associated to the minimum shipping rate

  - `products.offers.msrp` (number)
    The retail price recommendation, also referred to as manufacturer's suggested retail price (MSRP) or recommended retail price (RRP).

Applicable only for Dropship offers.

  - `products.offers.nb_evaluation` (integer, required)
    Number of customers evaluations

  - `products.offers.price` (number)
    Price of the offer

For Dropship specifically: the purchasing price of the offer, also referred to as cost or wholesale price

  - `products.offers.price_additional_info` (string)
    Additional price information for the offer

  - `products.offers.shipping_deadline` (string, required)
    Estimated shipping date, that includes business closing days and cut-off configured on the platform. Add the earliest and latest delivery times to calculate the estimated delivery date to customers

  - `products.offers.shipping_types` (array)
    List of shipping types compatible with the given offer

  - `products.offers.shipping_types.code` (string, required)
    Shipping type code

  - `products.offers.shipping_types.cut_off_next_date` (string)
    Next cutoff date

  - `products.offers.shipping_types.cut_off_time` (string)
    Shipping type Cutoff time

  - `products.offers.shipping_types.delivery_time` (object)
    Expected delivery time

  - `products.offers.shipping_types.delivery_time.earliest_days` (integer, required)
    Earliest order delivery time

  - `products.offers.shipping_types.delivery_time.earliest_delivery_date` (string, required)
    Earliest order delivery date

  - `products.offers.shipping_types.delivery_time.latest_days` (integer, required)
    Latest order delivery time

  - `products.offers.shipping_types.delivery_time.latest_delivery_date` (string, required)
    Latest order delivery date

  - `products.offers.shipping_types.label` (string, required)
    Shipping type label

  - `products.offers.shipping_types.shipping_price_type` (string, required)
    Shipping price type of the offer for a given zone method
    Enum: "FIXED_PRICE", "FREE_SHIPPING"

  - `products.offers.shipping_types.shipping_price_unit` (number, required)
    Shipping price of the offer

  - `products.offers.shipping_types.shipping_zone_code` (string, required)
    Shipping zone code

  - `products.offers.shipping_types.shipping_zone_label` (string, required)
    Shipping zone label

  - `products.offers.shipping_types.standard_code` (string)
    Shipping type standard code

  - `products.offers.shop_grade` (number, required)
    Grade of the shop which proposes the offer

  - `products.offers.shop_name` (string, required)
    Name of the shop which proposes the offer

  - `products.offers.state_code` (string, required)
    Offer condition

  - `products.offers.total_price` (number)
    Total price of the offer (price + minimum shipping rate)

For Dropship specifically: the purchasing price of the offer + minimum shipping rate

  - `products.offers.available_end_date` (string)
    Available end date

  - `products.offers.available_start_date` (string)
    Available start date

  - `products.offers.channels` (array, required)
    List of channel codes on which the offer can be sold

  - `products.offers.discount` (object)
    Discount of the offer

  - `products.offers.discount.discount_price` (number)
    Discount price. Not to be read if discount with ranges is specified (i.e. discount with at least one range with quantity threshold greater than one). For Dropship specifically: the purchasing discount price.

  - `products.offers.discount.end_date` (string)
    Discount end date

  - `products.offers.discount.origin_price` (number)
    Origin price For Dropship specifically: the origin purchasing price

  - `products.offers.discount.ranges` (array)
    Discount ranges

  - `products.offers.discount.ranges.price` (number, required)
    Price of the offer if the quantity threshold is reached

  - `products.offers.discount.ranges.quantity_threshold` (integer, required)
    Minimum quantity to order for the given price to be applied

  - `products.offers.discount.start_date` (string)
    Discount start date

  - `products.offers.favorite_rank` (integer)
    Favorite rank if the offer is favorite and if the favorite offer feature is enabled

  - `products.offers.logistic_class` (object, required)
    The logistic class associated to the offer

  - `products.offers.logistic_class.code` (string, required)
    Logistic class code

  - `products.offers.logistic_class.label` (string, required)
    Logistic class label

  - `products.offers.min_quantity_alert` (integer, required)
    Mininum quantity of the offer

  - `products.offers.offer_additional_fields` (array)
    List of custom fields

  - `products.offers.offer_additional_fields.code` (string, required)
    Custom field's code

  - `products.offers.offer_additional_fields.type` (string)
    Custom field's type
    Enum: "STRING", "DATE", "NUMERIC", "BOOLEAN", "LINK", "REGEX", "TEXTAREA", "LIST", "MULTIPLE_VALUES_LIST"

  - `products.offers.offer_id` (integer, required)
    Identifier of the offer

  - `products.offers.premium` (boolean, required)
    Shop is premium

  - `products.offers.quantity` (integer, required)
    Available quantity of the offer

  - `products.offers.shop_id` (integer, required)
    Shop offer ID

  - `products.product_brand` (string)
    Brand of the product

  - `products.product_description` (string)
    Description of the product

  - `products.product_media` (object)
    Media of the product

  - `products.product_media.dam_url` (string, required)
    DAM URL for the media provided when available, otherwise use media_url

  - `products.product_media.media_url` (string, required)
    Media URL

  - `products.product_media.type` (string, required)
    Media TYPE (small, large...)

  - `products.product_references` (array, required)
    List of product's references

  - `products.product_references.reference` (string, required)
    Value of the reference

  - `products.product_references.reference_type` (string, required)
    Type of the reference

  - `products.product_sku` (string, required)
    SKU of the product

  - `products.product_title` (string, required)
    Title of the product

  - `products.total_count` (integer, required)
    Number of offers for this product