Developers

Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.

Last update 22/04/2025

Moderations

The resource /infractions provides relevant information related to the moderations detected in any of the published elements (items, questions, answers and reviews of the product). Remember the seller is warned the first time. Then, he is warned again and suspended for 2 days (unable to operate on the platform). Finally, the seller received an ultimatum and will be suspended for 5 days (unable to operate on the platform).

Get infractions by user

We recommend that you identify the reason (reason) and solution (remedy) to apply in the language corresponding to the site of the infraction or in English, and in addition, you can identify and summarize the moderations for miscategorized posts.

items
questions or answers
products review

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/$USER_ID

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/12345678

Response:

{
   "infractions": [
       {
            "id": "632617313",
            "date_created": "2020-12-03T03:18:15.338-0400",
            "user_id": "123455",
            "related_item_id": "MLM123456",
            "element_id": "MLM123456",
            "element_type": "ITM",
            "site_id": "MLM",
            "reason": "Low quality cover image.",
            "remedy": "In order to maintain visibility, make sure that the first image has a solid white background created with an image editor. Do not add edges, logos or watermarks."
        }
   ],
   "paging": {
       "offset": 0,
       "limit": 2,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Response fields

id: unique identifier of the infraction.
date_created: date the infraction occurred.
user_id: the user who carried out the infraction.
related_item_id: unique identifier of the post related to the item that owns the infraction. If the violation is in a post, the value of this attribute will equal the value of the element_id attribute.
element_id: unique identifier of the item that owns the violation. It is dependent on the element_type attribute.
element_type: type of element, the values can be: ITM (listing), QUE (questions and answers) and REV (reviews /product opinion).
site_id: marketplace site of the item with the infraction.
reason: text (html) that describes the reason and infractions policy.
remedy: text (html) that indicates the action, only in cases where it is recoverable. For example, "Remove personal data from listing".

Note:

The response you will not see the items written out in duplicates and only the items in which the states can be final (forbidden) or temporary (waiting_for_patch, held, pending_documentation) appear. If you want to check if a user is suspended you can check the status => list => allow through the api of users. In case that field is false, it means that it is suspended.

Important:

In case the user is suspended, please check the account configuration in the Help site.

Consult infractions with filter

Available filters

Filter	Description	Options	Default
related_item_id	Post ID associated with the moderation	-	-
element_id	Id of the moderate element	-	-
element_type	Moderate element type	ITM (item) REV (review) QUE (question/aswer)	-
date_created_since	Filtering start date	Format: YYYY-MM-DD	-
date_created_to	Filtering end date	Format: YYYY-MM-DD	-
limit	Number of infractions returned	Integer from 1 to 20	20
offset	Offset for paging		0
sort	Sort results by creation date, ascending or descending	date_created_asc, date_created_desc	date_created_desc

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=X

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0

Response:

{
   "infractions": [
        {
            "id": "632617313",
            "date_created": "2020-12-03T03:18:15.338-0400",
            "user_id": "123455",
            "related_item_id": "MLM123456",
            "element_id": "MLM123456",
            "element_type": "ITM",
            "site_id": "MLM",
            "reason": "Low quality cover image.",
            "remedy": "In order to maintain visibility, make sure that the first image has a solid white background created with an image editor. Do not add edges, logos or watermarks."
        }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}