How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mirakl Products API

The Products API from Mirakl — 11 operation(s) for products.

Mirakl Products API is one of 34 APIs that Mirakl publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Product. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 12 operations across 11 paths, and defines 46 schemas. It is described by OpenAPI 3.2.0.

Requests are made against a single base URL, https://your-instance.mirakl.net.

12 operations 11 paths 46 schemas 11 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://your-instance.mirakl.net
Authentication
HTTP Bearer, OAuth 2.0, HTTP Bearer, API Key, HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 6

Mirakl Products API declares 6 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (Front-Bearer-Token). It supports OAuth 2.0 (OAuth-2) using the authorizationCode flow. It accepts HTTP bearer tokens (JWT) (Operator-Bearer-Token). An API key is passed in the header as Authorization (Shop-API-Key). It accepts HTTP bearer tokens (JWT) (operator_bearer_token). An API key is passed in the header as Authorization (shop_api_key).

  • OAuth-2 — For more information, see our [Authentication System documentation](https://help.mirakl.com/docs/customers/page/topics/Mirakl/partnersintegration/authenticatio…

Paths & Operations 12

Across 11 paths, the API surfaces 12 operations — 11 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Products 12
GET
/api/mcm/products/sources/status/export
CM11 - Export Source Product Data Sheet status
CM11 6 params → 200204
GET
/api/hierarchies
H11 - List Catalog categories (parents and children) related to a Catalog category
H11 2 params → 200
POST
/api/products/imports
P41 - Import products to the operator information system
P41 body → 201
GET
/api/products/imports
P51 - Get information about product import statuses
P51 4 params → 200
GET
/api/products/imports/{import}
P42 - Get the import status for a product import
P42 1 param → 200
GET
/api/products/imports/{import}/error_report
P44 - Get the error report file for a product import ("Non-integrated products report")
P44 1 param → 200
GET
/api/products/imports/{import}/new_product_report
P45 - Get the product integration report file for a product import ("Added products report")
P45 1 param → 200
GET
/api/products/imports/{import}/transformed_file
P46 - Get the transformed file for a product import ("File in operator format")
P46 1 param → 200
GET
/api/products/imports/{import}/transformation_error_report
P47 - Get the transformation error report file for a product import ("Source file error report")
P47 1 param → 200
GET
/api/products/attributes
PM11 - Get the product attribute configuration
PM11 4 params → 200
GET
/api/values_lists
VL11 - Get information about operator's value lists
VL11 1 param → 200
GET
/api/products
P31 - Get products for a list of product references
P31 2 params → 200

Schemas 46

The contract defines 46 schemas that model the data the API accepts and returns. The most detailed are PM11_Response_200_Attributes (22 properties), PM11_Response_200_TextCsv_Ext_FileStructure (22 properties), P51_Response_200_ProductImportTrackings (16 properties), P42_Response_200 (16 properties). Each schema is shown below with its type and property counts.

PM11_Response_200_Attributes_LabelTranslations
object
2 properties 2 required
P42_Response_200_ConversionOptions
object
3 properties
CM11_Response_200_Ext_FileStructure_UniqueIdentifiers
object
2 properties 2 required
PM11_Response_200_Attributes_Channels
object
1 property 1 required
VL11_Response_200
object
1 property
H11_Response_200_Hierarchies_LabelTranslations
object
2 properties
H11_Response_200
object
1 property 1 required
P51_Response_200
object
2 properties 1 required
VL11_Response_200_ValuesLists_Values
object
3 properties 2 required
PM11_Response_200_Attributes_Roles_Parameters
object
2 properties 2 required
P51_Response_200_ProductImportTrackings_ConversionOptions
object
3 properties
PM11_Response_200_Attributes
object
22 properties 9 required
CM11_Response_200_Ext_FileStructure_Errors
object
5 properties 2 required
H11_Response_200_Hierarchies
object
5 properties 4 required
P41_Response_201
object
1 property 1 required
PM11_Response_200
object
JSON output
1 property 1 required
PM11_Response_200_Attributes_DescriptionTranslations
object
2 properties 2 required
P42_Response_200
object
16 properties 11 required
PM11_Response_200_Attributes_Values
object
1 property 1 required
VL11_Response_200_ValuesLists
object
4 properties 2 required
CM11_Response_200_Ext_FileStructure_Errors_RejectionDetails
object
3 properties 2 required
P41_Request_MultipartFormData_ConversionOptions_AiRewrite
object
Enable AI translation. Default to DISABLED
1 property
PM11_Response_200_Attributes_TypeParameters
object
2 properties 2 required
PM11_Response_200_TextCsv_Ext_FileStructure
object
CSV output
22 properties 9 required
VL11_Response_200_ValuesLists_LabelTranslations
object
2 properties
P42_Response_200_ConversionOptions_AiEnrichment
object
1 property
CM11_Response_200_Ext_FileStructure_Warnings
object
3 properties 2 required
P51_Response_200_ProductImportTrackings_IntegrationDetails
object
8 properties
P42_Response_200_IntegrationDetails
object
8 properties
P41_Request_MultipartFormData_ConversionOptions_AiEnrichment
object
Enable AI translation. Default to DISABLED
1 property
P41_Request_MultipartFormData_ConversionOptions
object
3 properties
P42_Response_200_ConversionOptions_AiTranslation
object
1 property
P51_Response_200_ProductImportTrackings_ConversionOptions_AiEnrichment
object
1 property
VL11_Response_200_ValuesLists_Values_LabelTranslations
object
2 properties
P51_Response_200_ProductImportTrackings_ConversionOptions_AiTranslation
object
1 property
P42_Response_200_ConversionOptions_AiRewrite
object
1 property
CM11_Response_200_Ext_FileStructure
object
JSON output
5 properties 1 required
PM11_Response_200_Attributes_Roles
object
2 properties 2 required
P41_Request_MultipartFormData_ConversionOptions_AiTranslation
object
Enable AI translation. Default to DISABLED
1 property
P51_Response_200_ProductImportTrackings
object
16 properties 11 required
P51_Response_200_ProductImportTrackings_ConversionOptions_AiRewrite
object
1 property
CM11_Response_200_Ext_FileStructure_Errors_IntegrationDetails
object
3 properties 2 required
P31_Response_200
object
2 properties 2 required
P31_Response_200_Products
object
7 properties 7 required
P31_Response_200_2
object
2 properties 2 required
P31_Response_200_Products_2
object
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mirakl-products-api-openapi.yml Raw ↑

Other APIs Mirakl publishes across the network.

Mirakl Carriers API
Mirakl Catalog Configuration API
Mirakl Incidents API
Mirakl Invoicing and Accounting API
Mirakl Messages API
Mirakl Multiple shipments API
Mirakl Offers API
Mirakl Orders API
Mirakl Picklists API
Mirakl Platform Settings API
Mirakl Product Feedback API
Mirakl Promotions API
Where this information came from

This is an independent, third-party profile of Mirakl Products API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.