# Offers ## OF01 - Import a file to add offers - [POST /api/offers/imports](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of01.md): Returns the import identifier to track the status of the import.Call FrequencyRecommended usage: Every 5 minutesMaximum usage: Once per minuteRead MoreMore context ## OF04 - Get information and statistics about offer imports - [GET /api/offers/imports](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of04.md): Call FrequencyRecommended usage: Every 5 minutesMaximum usage: Once per minuteRead MoreMore contextPaginationThis resource supports seek pagination (see documentation)Sort fieldssort field can have the following values:dateCreated (Default) - Sort by creation date (desc by default) ## OF02 - Get information and statistics about an offer import - [GET /api/offers/imports/{import}](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of02.md): Call FrequencyRecommended usage: After each OF01 call, every 5 minutesMaximum usage: Once per minuteRead MoreMore context ## OF03 - Get the error report file for an offer import - [GET /api/offers/imports/{import}/error_report](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of03.md): This API returns a CSV, XLSX or XML file, depending on the file format provided by the seller.Call FrequencyRecommended usage: After each OF02 call, every 5 minutesMaximum usage: Once per minuteRead MoreMore context ## OF21 - List offers of a shop - [GET /api/offers](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of21.md): Call FrequencyRecommended usage: On each shop's offers page viewMaximum usage: On each shop's offers page viewRead MoreIf the "Price approval" option is activated, read this pagePrice prioritization for Advanced PricingPaginationThis resource supports offset pagination (see documentation)Sort fieldssort field can have the following values:totalPrice (Default) - Sort by total price (asc by default)price - Sort by price, total price (asc by default)productTitle - Sort by product title, total price (asc by default)LocalizationThis resource supports locale parameter (see documentation)Localized output fields will be highlighted with an icon: ## OF24 - Create, update, or delete offers - [POST /api/offers](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of24.md): Returns the import identifier to track the status of the update.You must send all offer fields. Offer fields that are not sent are reset to their default value.Call FrequencyRecommended usage: Every 5 minutesMaximum usage: Once per minute ## OF22 - Get information about an offer - [GET /api/offers/{offer}](https://developer.mirakl.com/content/product/mmp/rest/seller/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/seller/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 day ## 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/seller/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 seconds ## 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/seller/openapi3/offers/of54.md): Retrieve each chunk of an offer export file via the URL generated once the asynchronous offer export is complete ## P11 - List offers for each given product - [GET /api/products/offers](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/p11.md): 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: ## PRI01 - Import a price file - [POST /api/offers/pricing/imports](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/pri01.md): Import a .csv file to submit all applicable prices for an offer. The import mode is delete and replace: any existing price that is not submitted will be deleted. If Price Approval is enabled, this API creates and updates pending prices; ongoing prices will remain. Returns an import identifier to track the status of the import and retrieve an error report if applicable. Call FrequencyRecommended usage: Every 5 minutesMaximum usage: Once per minuteRead MoreImporting pricesAbout the price file format ## PRI02 - Get information and statistics about an offer pricing import - [GET /api/offers/pricing/imports](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/pri02.md): Call FrequencyRecommended usage: After each PRI01 call, every 5 minutesMaximum usage: Once per minuteRead MoreImporting pricesPaginationThis resource supports seek pagination (see documentation)Sort fieldssort field can have the following values:dateCreated (Default) - Sort by creation date (desc by default) ## PRI03 - Get the error report for a price import in CSV format - [GET /api/offers/pricing/imports/{import_id}/error_report](https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/pri03.md): Only returns lines of offers with at least one offer price in error. The first column contains the line number in error. The second column contains the error reason. The returned file is ready to be reimported after the values have been fixed. Offer prices that were submitted in the price import but don't appear in the error report were successfully imported. Call FrequencyRecommended usage: After each PRI02 call, every 5 minutesMaximum usage: Once per minuteRead MoreImporting prices ## OF26 - Get the quantity of stock available for an offer. (deprecated) - [GET /api/offers/{offer}/quantity](https://developer.mirakl.com/content/product/mmp/rest/seller/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/seller/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 day