Reported listings

Consult reported items

With the following resource, you can obtain a seller's reported items, the report date, expiration date (maximum deadline to respond to the report), reason for the report, the ID identifying the case, and its status.

Required parameters

Parameter	Description
offset	Limits the number of results. The maximum result per page is 50. To obtain the first results, you must send 0, then 50, 100, 150, 200, and so on.
date_created	Creation date of reports. With this parameter, you will delimit from one day to the current date.
status	Status of the report. Relevant statuses for sellers are: WAITING_DOCUMENTATION, DOCUMENTATION_PRESENTED, DOCUMENTATION_APPROVED, DOCUMENTATION_NOT_APPROVED, DOCUMENTATION_NOT_PRESENTED, MEMBER_NOT_RESPOND, ROLLBACK.

If you do not want to filter reports, you must obligatorily send the date_created and status fields empty: ?offset=0&date_created=&status=

Call:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/cases?offset=0&date_created=2022-04-01&status=$STATUS_ID

Example call:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/cases?offset=0&date_created=2022-04-01&status=DOCUMENTATION_APPROVED

Response:

[
    {
        "element_related_count": 1,
        "item_id": "MLM2007439322",
        "date_created": "2025-12-19T18:23:11Z",
        "due_date": "2025-12-23T18:34:28Z",
        "case_id": 36408927,
        "reason_text": "the product could be counterfeit.",
        "current_status": "WAITING_DOCUMENTATION",
        "user_product_ids": []
    },
    {
        "element_related_count": 1,
        "item_id": "MLB5324094348",
        "date_created": "2025-12-09T22:18:14Z",
        "due_date": "2025-12-13T13:35:54Z",
        "case_id": 36376014,
        "reason_text": "the product could be counterfeit.",
        "current_status": "DOCUMENTATION_NOT_PRESENTED",
        "user_product_ids": []
    },
    {
        "element_related_count": 1,
        "item_id": "MLM3601892554",
        "date_created": "2025-12-09T22:16:58Z",
        "due_date": "2025-12-13T13:35:26Z",
        "case_id": 36376013,
        "reason_text": "the product could be counterfeit.",
        "current_status": "DOCUMENTATION_NOT_PRESENTED",
        "user_product_ids": []
    },
    {
        "element_related_count": 1,
        "item_id": "MLM2475402207",
        "date_created": "2025-12-09T22:08:42Z",
        "due_date": "2025-12-13T13:29:17Z",
        "case_id": 36375990,
        "reason_text": "the product could be counterfeit.",
        "current_status": "DOCUMENTATION_NOT_PRESENTED",
        "user_product_ids": []
    },
    {
        "total": 4,
        "offset": 0,
        "limit": 50
    }
]

Response fields

item_id: item identifier.
date_created: creation date of the received report.
due_date: expiration date to respond to the report. If no response is provided, the report status will change to DOCUMENTATION_NOT_PRESENTED and the item will be moderated and deleted (forbidden).
case_id: report identifier. It allows getting more details about the received report.
reason_text: reason for the report.
current_status: current status of the report. This will change according to response and resolutions.

Learn about the different statuses:

Current_status	Name	Description	Item Status
DOCUMENTATION_APPROVED	Documentation approved	The report was responded to by the seller, the member approved the documentation and withdrew their report.	Active
DOCUMENTATION_NOT_APPROVED	Documentation not approved	The report was responded to by the seller, but the member ratified their report.	Deleted
DOCUMENTATION_NOT_PRESENTED	Documentation not presented	The report was not responded to by the seller.	Deleted
DOCUMENTATION_PRESENTED	Documentation presented	The report was responded to by the seller and is waiting for a response from the member.	Paused
MEMBER_NOT_RESPOND	Member did not respond	The report was responded to by the seller, but the reporter did not respond in time.	Active
ROLLBACK	Retracted	The report was retracted.	Active
WAITING_DOCUMENTATION	Waiting for response	We are waiting for a response to the report from the seller.	Paused

Consult reported item details

For more information about the case and the reported item, perform the following query:

Call:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$CASE_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/36408927

Response:

{
    "item_info": {
        "item_id": "MLM2007439322",
        "price": 16263.0,
        "description": "",
        "title": "Test Item, Please Do Not Bid Kc: Off",
        "pictures": [
            {
                "size": "500x500",
                "url": "https://http2.mlstatic.com/D_988787-CBT68829317273_042023-O.jpg",
                "max_size": "500x500"
            }
        ]
    },
    "last_updated": "2025-12-19T14:34:28.000-0400",
    "is_rollbackable": true,
    "documents": [],
    "date_created": "2025-12-19T14:23:11.000-0400",
    "photos_denounced": [],
    "reason_text": "the product could be counterfeit.",
    "due_date": "2025-12-23T14:34:28.000-0400",
    "user_product_ids": [],
    "photos_new": [],
    "member_quittance": null,
    "reason_id": "PPPI1",
    "document_name": null,
    "public_member_name": "FAKES IT",
    "element_related_count": 1,
    "case_id": 36408927,
    "current_status": "WAITING_DOCUMENTATION",
    "seller_quittance": null,
    "document_url": null
}

Response fields

item_info: relevant item information.
last_updated: date of the last report update.
date_created: creation date of the report.
photos_denounced: reported images.
reason_text: reason for the received report.
due_date: expiration date to respond to the report.
photos_new: new images to add to the item. Once the report is responded to with this field, Mercado Libre adds the picture IDs to the listing.
case_id: report identifier.
user_product_ids: user product ID.
member_quittance: program member's comment.
document_name: name of the document sent by the member.
public_member_name: public name of the program member.
current_status: current status of the report.
document_url: URL of the document sent by the member.
reason_id: report identifier.

Learn about the different types of reports:

Reason ID	Name	Description
PPPI1	Counterfeit Product	It is a copy or counterfeit of a product that was not manufactured by the brand.
PPPI2	Trademark misuse	Uses the brand improperly in the listing. For example: in the title, description, photos, etc.
PPPI3	Copyright - Software	The listing offers a computer program that infringes rights.
PPPI5	Copyright - Books	The listing offers a literary work that infringes rights.
PPPI6	Copyright - Images	The listing contains images and/or photos that the seller does not have authorization to use.
PPPI7	Copyright - Personal Image	Uses the personal image of the reporter.
PPPI8	Industrial Design or Model	Infringes an industrial model or design.
PPPI9	Infringes patents, utility models, or plant variety rights	Infringes patents, utility models, or plant variety rights.
PPPI10	Product not intended for sale.	Ex. Free samples, products not launched in the Brazilian market, other products delivered as collateral.
PPPI11	Copyright - Courses	The listing offers a course that infringes rights.
PPPI12	Copyright - Video games	The listing offers a video game that infringes your rights.
PPPI14	Copyright - Videos / Movies	Videos / Movies. The listing offers an audiovisual work that infringes my rights.
PPPI15	Copyright - Music	The listing offers musical content that infringes your rights.
PPPI16	Copyright - Character	Character. The listing offers products that include characters without authorization.
PPPI17	Copyright - Others	The listing offers another type of work (drawing, painting, sculpture, etc.) that infringes your rights.
PPPI18	Related Rights - Illegal reproductions	Unauthorized linkages or reproductions.
PPPI19	Related Rights - Personal image	Uses personal image associated with artistic interpretation without authorization.
PPPI20	Related Rights - Audio Material	Uses audio material without authorization. Recorded music or sounds.
PPPI21	Related Rights - Audiovisual Material	Movies, series, videos, recordings of recitals, shows, and sporting events.
PPPI22	Related Rights - Illegal transmission	Services to access signals illegally.
PPPI23	Related Rights - Illegal device	Devices that capture signals illegally.

Flow to respond to reports

1. Identify response type

• If the seller has rights to use the images, they must respond to the report with a comment (optional) and attach the document (mandatory).
• If the seller does not have rights to these images, they must upload new images and send the IDs of the new images and the IDs of the deleted images in their response. Use our /pictures API.
• By documentation: the seller must respond to the report with a comment (mandatory) and documentation (optional). Before sending the response, we recommend uploading the document to the endpoint.

2. Upload supporting document

Once sellers differentiate whether it is a report for use of images (sending images + documents) or documents, they must upload the document to Mercado Libre in the following way:

Required parameters

case_id: report identifier.
name: file name.
form: official file or document that proves the report response.

Call:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/files?case_id=$CASE_ID&name=$NAME_FILE.JPG -Form =@/Users/Name/Example/report-document-Nike.jpg

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/files?case_id=32679944&name=testFile.jpg'--form '=@"/Users/Name/Example/report-document-Nike.jpg"'

Response:

{
  "file_name":"32679944.jpg"
}

This file_name must be used for the document_name field when attaching supporting documentation to a report.

3. Send response to report

Response for image use (without variations):

seller_quittance: seller comment.
document_name: name of the document sent by the member.
photos_new: new photos that the seller will send and Mercado Libre will upload these images to the item.
photos_removed: ID of the images to be deleted. Mercado Libre will delete these images.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
  "seller_quittance": "comment",
  "document_name": "32618474.png",
  "photos_new": ["799744-MLA1234_112022"],
  "photos_removed": ["637858-MLA124_112022"],
  "variations": []
}

Response for image use (with variations):

variations: indicates the ID of the item variation with the images that you want to remain in the listing.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
  "seller_quittance": "test",
  "document_name": "32618474.png",
  "photos_new": ["799744-MLA1234_112022"],
  "photos_removed": ["637858-MLA124_112022"],
  "variations": [{
    "id": "16787985187",
    "picture_ids": [
      "111111 - EXISTING_IMAGE_111111",
      "111111 - EXISTING_IMAGE_111111",
      "111111 - EXISTING_IMAGE_111111"
    ]
  }]
}

Learn more about how to work with images.

Report response with document:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
  "seller_quittance": "seller comment",
  "document_name": "32618474.png"
}

Recommendations for responding to reports

Infringement	Reason	Expected response
Counterfeit product, copies or replicas	It is illegal to sell counterfeits, copies, or replicas of a registered brand's products, and listing these types of products is prohibited by our Terms and Conditions.	- Send photos of the purchase invoice proving the product is original, that it was purchased legally, and justifying the stock offered in your listing. - Send images of the labels and original product packaging. The rights holder could ask for specific documentation to be attached for the response.
Illegal use of registered trademark	A registered trademark is a distinctive sign (such as a word, phrase, or logo) used to identify products or services.	- Attach a copy of the rights holder's authorization. - If you are the owner of the brand being used, send a copy of your trademark title.
Pirated software	It is illegal to sell unauthorized copies of software, and listing these types of products is prohibited by our Terms and Conditions.	Send a copy of the license authorizing you to distribute the software.
Copyright infringements	Protects original intellectual works such as movies, music, photographs, and books. Copyright protection prevents others from using a work without permission.	- Prove you are the rights holder. - Send a copy of the authorization given by the holder to use their work. - Send a copy of the work's deposit certificate.
Related rights infringements	Gives protection to those who, without being the author, contribute with creativity, technique, or organization in the process of making a work available to the public.	- Send authorizations to record your performance or interpretation. If it is a report from phonogram and videogram producers, attach: - Purchase invoices for copies issued by an authorized distributor of the phonograms or videograms. - Contracts authorizing consignment sales. - Licenses to reproduce phonograms or videograms. If it is a report from a broadcasting organization, send: - License authorizing you to distribute or retransmit the signal of the reporting organization.
Infringement of a patent or utility model	It is an exclusive right granted to an invention (product or process) that implies a new, non-obvious technical solution with industrial application.	- Prove you are the patent holder. - Send a copy of the authorization given by the holder to commercially exploit their invention.
Infringement of an industrial model or design	Protects the ornamental or aesthetic aspect applied to a product.	- Prove you are the holder of these rights. - Send a copy of the authorization given by the holder for commercial exploitation, including their protected rights.
Product not intended for sale	The brand owner did not intend it for commercial purposes, thus did not deliver it to be sold, for example, free samples or test samples, or products delivered as collateral. In Brazil, it is an infringement to sell a product that has not been officially launched in this market by the rights holder or with their authorization.	Send documentation to the reporter proving you purchased the product without any limitations for selling it.

Test reports

If you want to test this functionality with test users, access support. The item IDs sent must have the status: active, tag test_item, and catalog_listing: false.