Recursos para IA
Consultar tarefa de criação do relatório de Outras operações

Retorna o status e os detalhes de uma tarefa específica de geração de um relatório de Outras operações, identificada pelo uid. Use este endpoint para acompanhar a tarefa enquanto o status for pending e até que mude para available, failed ou empty. Em caso de sucesso, a requisição retorna uma resposta HTTP 200.

GET

https://api.mercadopago.com/v1/reporting/operations/{reportId}/statements/{uid}
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
reportId
string

OBRIGATÓRIO

Tipo de relatório de Outras operações.
activities_collection: Relatório de cobranças.
activities_after_collection: Relatório pós-cobrança.
activities_withdraw: Relatório de retiradas.
uid
string

OBRIGATÓRIO

Identificador único (UUID) da tarefa de geração, retornado como record_id ao criar o relatório.
Response parameters
id
string
Identificador único (UUID) da tarefa de geração do relatório. Este valor corresponde ao uid enviado na requisição.
status
string
Status atual de geração do relatório. Os valores possíveis são:
pending: A tarefa de geração está aguardando processamento.
available: A tarefa de geração foi concluída com sucesso e o relatório está disponível para download.
failed: A tarefa de geração não pôde criar o relatório devido a um erro.
date_start
string
Data e hora de início do período abrangido pelo relatório, no formato ISO 8601.
date_end
string
Data e hora de fim do período abrangido pelo relatório, no formato ISO 8601.
Erros

403O relatório não pertence ao usuário autenticado.

forbidden

O relatório não pertence ao usuário associado ao Access Token. Use o token da conta que gerou o relatório e verifique o uid antes de tentar novamente.

404Relatório não encontrado.

not_found

Nenhum relatório foi encontrado para o uid e o reportId informados. Verifique os dois identificadores ou liste os relatórios gerados para obter um uid válido.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/statements/{uid}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
    
Response
{
  "id": "6d17e034-6eb3-48fc-a6fa-461e886fa406",
  "status": "available",
  "date_start": "2026-03-01T00:00:00Z",
  "date_end": "2026-03-31T23:59:59Z",
  "date_created": "2026-03-31T15:42:30Z",
  "created_by": "manual",
  "structure": {
    "id": "aaaabbbb-1111-2222-3333-ccccddddeeee"
  },
  "files": [
    {
      "type": "text/csv",
      "name": "activities_collection.csv",
      "has_zip_version": false,
      "url": "https://api.mercadopago.com/v1/reporting/operations/activities_collection/statements/6d17e034-6eb3-48fc-a6fa-461e886fa406/download?format=csv"
    }
  ],
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "type": "webhook",
      "status": "ACTIVE",
      "version": 1
    }
  ]
}