Publicaciones denunciadas

Consultar ítems denunciados

Con el siguiente recurso podrás obtener ítems denunciados de un vendedor, fecha de la denuncia, fecha de vencimiento (plazo máximo para responder a la denuncia), motivo de la denuncia, el id que identifica el caso y su estado.

Parámetros obligatorios

Si no quieres filtrar las denuncias, deberás enviar obligatoriamente los campos date_created y status vacíos: ?offset=0&date_created=&status=

Llamada:

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

Llamada ejemplo:

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

Respuesta:

[
  {
    "case_id": 37111392,
    "item_id": "MLA6759546426",
    "current_status": "DOCUMENTATION_APPROVED",
    "date_created": "2026-05-19T14:50:52Z",
    "due_date": "2026-05-26T15:11:44Z",
    "element_related_count": 1,
    "reason_text": "Tu producto puede estar utilizando su marca de forma ilegítima (por ejemplo, mencionar que eres un distribuidor oficial cuando en realidad no lo eres, incluir sus logotipos en la descripción o en las imágenes del anuncio).",
    "user_product_ids": []
  },
  {
    "case_id": 37111394,
    "item_id": "MLA6759545714",
    "current_status": "DOCUMENTATION_APPROVED",
    "date_created": "2026-05-19T14:50:52Z",
    "due_date": "2026-05-26T15:11:45Z",
    "element_related_count": 1,
    "reason_text": "Tu anuncio puede estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
    "user_product_ids": []
  },
  {
    "total": 2,
    "offset": 0,
    "limit": 50
  }
]

Campos de respuesta

item_id: identificador del ítem.
date_created: fecha de creación de la denuncia recibida.
due_date: fecha de vencimiento para responder la denuncia. Si no responde, el estado de la denuncia pasará a DOCUMENTATION_NOT_PRESENTED y el ítem será moderado y eliminado (forbidden).
case_id: identificador de denuncia. Permitirá conocer más detalle de la denuncia recibida.
reason_text: motivo de la denuncia.
current_status: estado actual de la denuncia. Este cambiará conforme a la respuesta y resoluciones.

Conoce los diferentes status:

Consultar detalle del ítem denunciado

Para más información sobre el caso y el ítem denunciado, realiza la siguiente consulta:

Llamada:

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

Ejemplo:

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

Respuesta:

{
  "case_id": 37168941,
  "current_status": "DOCUMENTATION_NOT_PRESENTED",
  "item_info": {
    "item_id": "MLB6759545714",
    "price": 980,
    "title": "Michelin Ii Primacy Test Bpp"
  },
  "reason_id": "PPPI6",
  "public_member_name": "FAKES IT",
  "date_created": "2026-05-28T08:56:36.000-0400",
  "due_date": "2026-05-01T08:56:36.000-0400",
  "last_updated": "2026-05-28T10:40:31.000-0400",
  "is_rollbackable": true,
  "documents": [],
  "document_name": null,
  "document_url": null,
  "photos_denounced": [
    {
      "id": "904878-MLA99980238649_112025",
      "status": "ACTIVE"
    },
    {
      "id": "996479-MLA52729912696_122022",
      "status": "ACTIVE"
    },
    {
      "id": "665684-MLA52729912700_122022",
      "status": "ACTIVE"
    }
  ],
  "photos_new": [],
  "element_related_count": 1,
  "member_quittance": null,
  "seller_quittance": null,
  "user_product_ids": []
}

Campos de respuesta

item_info: información relevante del ítem.
last_updated: fecha de la última actualización de la denuncia.
date_created: fecha de creación de la denuncia.
photos_denounced: imágenes denunciadas.
due_date: fecha de vencimiento para responder a la denuncia.
photos_new: imágenes nuevas para añadir al ítem. Una vez respondida la denuncia con este campo, Mercado Libre añade las pictures id en la publicación.
case_id: identificador de denuncia.
user_product_ids: id del user product.
member_quittance: comentario del miembro del programa.
document_name: nombre del documento enviado por el miembro.
public_member_name: nombre público del miembro del programa.
current_status: estado actual de la denuncia.
document_url: url del documento enviado por el miembro.
reason_id: identificador de la denuncia.
is_rollbackable: indica si la denuncia puede ser revertida. Es un valor booleano (true / false). Retorna true únicamente cuando current_status es uno de los siguientes: WAITING_DOCUMENTATION, DOCUMENTATION_NOT_PRESENTED, DOCUMENTATION_NOT_APPROVED o WAITING_FOR_PATCH_PDP. En cualquier otro estado, retorna false.

Conoce los diferentes tipos de denuncias:

Flujo para responder denuncias

1. Identificar tipo de respuesta

• Si el vendedor tiene derechos de uso de las imágenes, deberá responder a la denuncia con un comentario (opcional) y adjuntar el documento (obligatorio).
• Si el vendedor no tiene derechos sobre estas imágenes, deberá cargar nuevas imágenes y enviar en su respuesta los ids de las imágenes nuevas y los ids de las imágenes eliminadas. Utiliza nuestra API de /pictures.
• Por documentación: el vendedor debe responder a la denuncia con un comentario (obligatorio) y con la documentación (opcional). Antes de enviar la respuesta, recomendamos cargar el documento en el endpoint.

2. Cargar documento probatorio

Una vez que los vendedores diferencien si se trata de una denuncia por uso de imágenes o documentación, deberán cargar el documento en Mercado Libre de la siguiente manera:

Parâmetros obrigatórios

case_id: identificador de la denuncia.
name: nombre del archivo.
form: archivo o documento oficial que pruebe la respuesta de la denuncia.

Llamada:

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/Nombre/Ejemplo/documento-denuncia-Nike.jpg

Ejemplo:

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

Respuesta:

{
  "file_name":"32679944.jpg"
}

Este file_name debe ser utilizado para el campo document_name al momento de adjuntar una documentación comprobatoria ante una denuncia.

3. Enviar respuesta ante denuncia

Respuesta por uso de imágenes (sin variaciones):

seller_quittance: comentario del vendedor.
document_name: nombre del documento enviado por el miembro.
photos_new: fotos nuevas que el vendedor enviará y Mercado Libre cargará en el ítem.
photos_removed: id de las imágenes que desea eliminar. Mercado Libre eliminará estas imágenes.

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

Respuesta por uso de imágenes (con variaciones):

variations: indica el id de la variación del ítem con las imágenes que desea que permanezcan en la publicación.

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 - IMAGEN_EXISTENTE_111111",
      "111111 - IMAGEN_EXISTENTE_111111",
      "111111 - IMAGEN_EXISTENTE_111111"
    ]
  }]
}

Conoce más sobre cómo trabajar con imágenes.

Respuesta de denuncia con documento:

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

Recomendaciones para responder denuncias