# OF22 - Get information about an offer

Call FrequencyRecommended usage: At each offer page displayMaximum usage: At each offer page displayRead MoreIf the "Price approval" option is activated, read this pagePrice prioritization for Advanced PricingLocalizationThis resource supports locale parameter (see documentation)Localized output fields will be highlighted with an icon: 

Endpoint: GET /api/offers/{offer}

## Path parameters:

  - `offer` (integer, required)
    Offer identifier

## Query parameters:

  - `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.

  - `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):

  - `active` (boolean, required)
    Is the offer active

  - `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

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

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

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

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

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

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

  - `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.

  - `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.

  - `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.

  - `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.

  - `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

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

  - `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.

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

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

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

  - `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.

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

  - `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.

  - `available_end_date` (string)
    Available end date

  - `available_start_date` (string)
    Available start date

  - `category_code` (string, required)
    Product category code

  - `category_label` (string, required)
    Product category label

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

  - `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"

  - `description` (string, required)
    Offer description

  - `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.

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

  - `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"

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

  - `favorite_rank` (integer)
    Favorite rank for the offer, when the favorite feature is enabled and the offer is a favorite

  - `fulfillment` (object, required)
    Fulfillment information

  - `fulfillment.center` (object, required)
    Fulfillment center code

  - `fulfillment.center.code` (string, required)
    Center code

  - `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"

  - `internal_description` (string)
    The offer's description as shown in the back office

  - `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.

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

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

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

  - `max_order_quantity` (integer, required)
    Highest quantity of product items per order

  - `min_order_quantity` (integer, required)
    Lowest quantity of product items per order

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

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

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

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

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

  - `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.

  - `offer_additional_fields` (array)
    Custom fields of the offer

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

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

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

  - `package_quantity` (integer, required)
    Indivisible quantity of the same product

  - `price` (number)
    Price of the offer

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

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

  - `product_brand` (string)
    Brand of the product

  - `product_description` (string)
    Description of the product

  - `product_references` (array, required)
    Product references

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

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

  - `product_sku` (string, required)
    Product SKU

  - `product_tax_code` (string)
    Offer product tax code

  - `product_title` (string, required)
    Product title

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

  - `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

  - `shop_sku` (string, required)
    Shop's sku of the offer

  - `state_code` (string, required)
    Offer condition

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

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

  - `discount` (object)
    Discount of the offer

  - `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.

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

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

  - `discount.ranges` (array)
    Discount ranges

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

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

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