Recursos para IA
Criar relatório de Outras operações

Solicita a geração manual de um relatório de Outras operações do tipo indicado pelo reportId, usando o intervalo de datas e os filtros enviados no corpo da requisição. A geração é assíncrona: a resposta retorna um record_id, que deve ser usado como uid para consultar o status do relatório com GET /statements/{uid}. Em caso de sucesso, a requisição retorna uma resposta com status 200.

POST

https://api.mercadopago.com/v1/reporting/operations/{reportId}/statements
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.
Body
filters
object

OBRIGATÓRIO

Agrupa os critérios usados para selecionar as operações da conta que serão incluídas no relatório gerado.
file_format
string
Formato do arquivo do relatório gerado. Por exemplo, application/csv.
Response parameters
result
string
Resultado da requisição de geração do relatório. O valor ok indica que a requisição foi aceita com sucesso.
record_id
string
Identificador único (UUID) da tarefa de geração do relatório. Use este valor como uid para consultar o status do relatório e baixar o arquivo quando es
Erros

400Intervalo de datas inválido ou incompleto.

invalid_date_range

O intervalo de datas solicitado está incompleto ou é inválido. Envie gte e lte no formato ISO 8601 com offset de UTC, verifique se gte é anterior ou igual a lte e use um período de no máximo um ano. Depois, envie a requisição novamente.

409Um relatório com a mesma chave de deduplicação já está em andamento.

export_already_requested

Um relatório equivalente já está sendo gerado para o mesmo usuário, reportId, intervalo de datas e filtros. Não envie uma requisição duplicada. Liste ou busque os relatórios para obter o identificador do relatório existente e consulte seu status até o processamento terminar.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/statements'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    -d '{
  "filters": {
    "creation_date": {
      "range": {
        "gte": "2026-03-01T00:00:00.000-03:00",
        "lte": "2026-03-31T23:59:59.999-03:00"
      }
    }
  },
  "file_format": "application/csv"
}'
Response
{
  "result": "ok",
  "record_id": "6d17e034-6eb3-48fc-a6fa-461e886fa406"
}