Recursos para IA
Consultar lista de relatórios de Outras operações

Lista os relatórios de Outras operações gerados em ordem decrescente de data de criação. Você pode paginar os resultados ou filtrá-los por status de geração, data de criação e origem. Em caso de sucesso, a requisição retorna uma resposta com status 200.

GET

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.
Query
size
integer
Resultados por página; padrão 30, máximo 1000.
page
integer
Número da página; padrão 1.
status
string
Status de geração usado para filtrar os relatórios. Para filtrar por mais de um status, envie os valores separados por vírgulas. Os valores possíveis são:
pending: O relatório está pendente de processamento.
available: O relatório foi gerado com sucesso e está disponível para download.
failed: Ocorreu um erro durante a geração do relatório.
created_from
string
Data e hora de início usadas para filtrar os relatórios pela data de criação. São retornados os relatórios criados a partir desse valor. Use o formato ISO 8601.
Response parameters
pagination
object
Informações de paginação da lista de relatórios retornada.
results
array
Lista de relatórios que correspondem aos critérios de busca.
Erros

400Filtro inválido.

invalid_filter

Um ou mais filtros de busca são inválidos ou não se aplicam ao tipo de relatório selecionado. Verifique os filtros aceitos e seus valores para o reportId informado. Depois, envie a requisição novamente.

401Access Token inválido.

invalid_token

O Access Token é inválido, expirou ou não tem permissão de leitura. Verifique o token enviado no header Authorization e seus escopos. Depois, envie a requisição novamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/statements?size=30&page=1&created_from=2026-03-01T00:00:00Z&created_to=2026-03-31T23:59:59Z'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    
Response
{
  "pagination": {
    "page": 1,
    "size": 30,
    "total": 8
  },
  "results": [
    {
      "id": "6d17e034-6eb3-48fc-a6fa-461e886fa406",
      "date_start": "2026-09-01T05:00:00Z",
      "date_end": "2026-09-03T04:59:59Z",
      "status": "available",
      "date_created": "2026-03-31T15:42:30Z",
      "created_by": "manual",
      "report": {
        "id": "activities_collection",
        "name": "Collections export",
        "topic": "operations",
        "version": "1"
      },
      "files": [],
      "origin": {
        "type": "date_range",
        "data": {
          "filters": {
            "creation_date": {
              "range": {
                "gte": "2026-09-01T00:00:00.000-05:00",
                "lte": "2026-09-02T23:59:59.999-05:00"
              }
            }
          }
        }
      },
      "structure": {
        "id": "c79ac093-ffb4-403f-85a8-59811e23aa46"
      },
      "notifiers": [
        {}
      ]
    }
  ]
}