# 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 Frequency

Recommended usage: At each offer page display
Maximum usage: At each offer page display
Read More

If the "Price approval" option is activated, read this pagePrice prioritization for Advanced PricingLocalization

This 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): Description

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 Frequency

Recommended usage: - Differential: every 5 minutes - Full: once per day
Maximum usage: - Differential: once per minute - Full: once per day
Read More

Exporting 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): Description

Retrieve the status for an OF52 offer export.
When the export is complete, the URLs to retrieve the files are returned.



Call Frequency

Recommended usage: Once per minute until you get an error or a success
Maximum usage: Every 10 seconds
Read More

Exporting 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): Description

Retrieve each chunk of an offer export file via the URL generated once the asynchronous offer export is complete


Read More

Exporting 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): Description

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 Frequency

Recommended usage: At each product page display
Maximum usage: At each product page display
Read More

More 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 P11Pagination

This resource supports offset pagination (see documentation)

Sort fields

sort 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)

Localization

This 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): Description

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): Deprecated endpoint

This API is going to be removed in a future update, please use APIs OF52, OF53, and OF54 instead.

Description

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 Frequency

Recommended usage: - Differential: every 5 minutes - Full: once per day
Maximum usage: - Differential: once per minute - Full: once per day
Read More

More context about exporting offers (synchronous)More context about integrating offers from sellers