Publicações denunciadas

Consultar itens denunciados

Com o recurso a seguir, você poderá obter os itens denunciados de um vendedor, a data da denúncia, a data de vencimento (prazo máximo para responder à denúncia), o motivo da denúncia, o ID que identifica o caso e seu status.

Parâmetros obrigatórios

Se você não quiser filtrar as denúncias, deverá enviar obrigatoriamente os campos date_created e status vazios: ?offset=0&date_created=&status=

Chamada:

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

Exemplo de chamada:

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

Resposta:

[
  {
    "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": "Seu produto pode estar utilizando a marca de forma ilegítima (por exemplo, mencionar que você é um distribuidor oficial quando, na realidade, não é, incluir os logotipos da marca na descrição ou nas imagens do anúncio).",
    "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": "Seu anúncio pode estar utilizando uma cópia ilegal de imagens protegidas por direitos autorais (fotos de catálogo protegidas, personagens de desenhos animados, vídeos, imagens de celebridades).",
    "user_product_ids": []
  },
  {
    "total": 2,
    "offset": 0,
    "limit": 50
  }
]

Campos da resposta

item_id: identificador do item.
date_created: data de criação da denúncia recebida.
due_date: data de vencimento para responder à denúncia. Se você não responder, o status da denúncia passará para DOCUMENTATION_NOT_PRESENTED e o item será moderado e removido (forbidden).
case_id: identificador da denúncia. Permitirá conhecer mais detalhes da denúncia recebida.
reason_text: motivo da denúncia.
current_status: status atual da denúncia. Ele mudará conforme as respostas e decisões.

Conheça os diferentes status:

Consultar detalhes do item denunciado

Para obter mais informações sobre o caso e o item denunciado, faça a seguinte consulta:

Chamada:

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

Exemplo:

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

Resposta:

{
  "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 da resposta

item_info: informações relevantes do item.
last_updated: data da última atualização da denúncia.
date_created: data de criação da denúncia.
photos_denounced: imagens denunciadas.
due_date: data de vencimento para responder à denúncia.
photos_new: novas imagens para adicionar ao item. Depois que a denúncia for respondida com esse campo, o Mercado Livre adicionará os IDs das imagens à publicação.
case_id: identificador da denúncia.
user_product_ids: ID do produto do usuário.
member_quittance: comentário do membro do programa.
document_name: nome do documento enviado pelo membro.
public_member_name: nome público do membro do programa.
current_status: status atual da denúncia.
document_url: URL do documento enviado pelo membro.
reason_id: identificador da denúncia.
is_rollbackable: indica se a denúncia pode ser revertida. É um valor booleano (true / false). Retorna true somente quando current_status é um dos seguintes: WAITING_DOCUMENTATION, DOCUMENTATION_NOT_PRESENTED, DOCUMENTATION_NOT_APPROVED ou WAITING_FOR_PATCH_PDP. Em qualquer outro status, retorna false.

Conheça os diferentes tipos de denúncias:

Fluxo para responder às denúncias

1. Identificar o tipo de resposta

• Se o vendedor tiver direitos de uso das imagens, deverá responder à denúncia com um comentário (opcional) e anexar o documento (obrigatório).
• Se o vendedor não tiver direitos sobre essas imagens, deverá carregar novas imagens e enviar, em sua resposta, os IDs das novas imagens e os IDs das imagens removidas. Utilize nossa API de /pictures.
• Por documentação: o vendedor deve responder à denúncia com um comentário (obrigatório) e com a documentação (opcional). Antes de enviar a resposta, recomendamos carregar o documento no endpoint.

2. Carregar documento comprobatório

Depois que os vendedores identificarem se a denúncia é por uso de imagens ou por documentação, deverão carregar o documento no Mercado Livre da seguinte maneira:

Parâmetros obrigatórios

case_id: identificador da denúncia.
name: nome do arquivo.
form: arquivo ou documento oficial que comprove a resposta à denúncia.

Chamada:

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

Exemplo:

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"'

Resposta:

{
  "file_name":"32679944.jpg"
}

Esse file_name deve ser utilizado no campo document_name ao anexar uma documentação comprobatória a uma denúncia.

3. Enviar resposta à denúncia

Resposta por uso de imagens (sem variações):

seller_quittance: comentário do vendedor.
document_name: nome do documento enviado pelo membro.
photos_new: novas fotos que o vendedor enviará e o Mercado Livre carregará no item.
photos_removed: ID das imagens que deseja remover. O Mercado Livre removerá essas imagens.

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

Resposta por uso de imagens (com variações):

variations: indica o ID da variação do item com as imagens que deseja manter na publicação.

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

Saiba mais sobre como trabalhar com imagens.

Resposta à denúncia com documento:

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

Recomendações para responder às denúncias