# Offers

## OF22 - Get information about an offer

 - [GET /api/offers/{offer}](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of22.md): 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: 

## OF52 - Export offers CSV or JSON file asynchronously

 - [POST /api/offers/export/async](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of52.md): Export status and files links can be retrieved by calling OF53.Get a CSV or JSON file that includes the offers updated and deleted since the last request date.

To ease testing processes, the minimum values for "megabytes_per_chunk" and "items_per_chunk" have been lowered on TEST and DEV environments.
Please adapt these values on PROD environments.

Call FrequencyRecommended usage: - Differential: every 5 minutes - Full: once per dayMaximum usage: - Differential: once per minute - Full: once per dayRead MoreExporting offers with advanced pricesExporting offers asynchronously - APIs OF52/53

## OF53 - Poll the status of an asynchronous offer export (OF52)

 - [GET /api/offers/export/async/status/{tracking_id}](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of53.md): Retrieve the status for an OF52 offer export.
When the export is complete, the URLs to retrieve the files are returned.
Call FrequencyRecommended usage: Once per minute until you get an error or a successMaximum usage: Every 10 secondsRead MoreExporting offers with advanced pricesExporting offers asynchronously - APIs OF52/53

## OF54 - Retrieve offer files once asynchronous offer export is complete (OF52)

 - [GET /dynamic-url/The+URL+is+retrieved+from+OF53+output/OF54](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of54.md): Retrieve each chunk of an offer export file via the URL generated once the asynchronous offer export is completeRead MoreExporting offers with advanced pricesExporting offers asynchronously - APIs OF52/53

## P11 - List offers for each given product

 - [GET /api/products/offers](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/p11.md):     List offers for each given product    
    By default, users calling this API with a Seller API key can retrieve both their own offers and some of their competitors’ data. If you want to prevent them from accessing competitors’ data, please contact the Mirakl Support Team.
    
Call FrequencyRecommended usage: At each product page displayMaximum usage: At each product page displayRead MoreMore context (Displaying different prices per channel)More context (Listing offers eligible for quotes)If 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: 

## OF26 - Get the quantity of stock available for an offer. (deprecated)

 - [GET /api/offers/{offer}/quantity](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of26.md): Quantity return rules: 0: if quantity = 0 or the offer is not available x: quantity available

## OF51 - Get offers CSV file (deprecated)

 - [GET /api/offers/export](https://developer.mirakl.com/content/product/mmp/rest/front/openapi3/offers/of51.md): Get a CSV file that includes the offers updated and deleted since the last request date.For deleted offers, only offer-id, product-sku, shop-id, shop-sku, active and deleted columns are returned. If the last_request_date param is not set the api returns all the active offers (inactive offers can be included with include_inactive_offers parameter).If offers have custom fields, a column is added for each existing custom field with as header the code of the custom field.Results are sorted by offer identifier.Call FrequencyRecommended usage: - Differential: every 5 minutes - Full: once per dayMaximum usage: - Differential: once per minute - Full: once per dayRead MoreMore context about exporting offers (synchronous)More context about integrating offers from sellers