Consultar relatório específico - Liberações - Mercado Pago Developers
Buscar relatório específico

Este endpoint permite buscar relatórios filtrando de acordo com diversos critérios. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

https://api.mercadopago.com/v1/account/release_report/search
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.
Query
id
integer
Identificador específico do relatório a buscar.
file_name
string
Nome exato do arquivo do relatório a buscar. Este campo é sensível a maiúsculas e minúsculas, por isso deve ser exato.
begin_date
string
Data de início do período reportado, ou seja, o momento em que a coleta de informação começou, não a data de criação do relatório. O formato deve ser ISO 8601 UTC (YYYY-MM-DDTHH:mm:ssZ).
end_date
string
Data de finalização do período reportado, ou seja, o momento em que a coleta de informação terminou. O formato deve ser ISO 8601 UTC (YYYY-MM-DDTHH:mm:ssZ).
Response parameters
paging
object
Informações de paginação.
results
array
Lista de relatórios que correspondem aos critérios de busca. Os resultados são ordenados por data de criação em ordem decrescente (mais recentes primeiro).
Erros

400Bad Request. Parâmetros inválidos na solicitação.

invalid_id

O valor informado para o 'id' do relatório é inválido. Valida se a informação enviada é correta e tenta novamente.

invalid_offset

O offset não é válido ou excede o valor máximo de 10000. Valida se a informação enviada é correta e tenta novamente.

invalid_limit

O limite não é válido ou excede o valor máximo de 500. Valida se a informação enviada é correta e tenta novamente.

invalid_range

O valor informado para o parâmetro 'range' é inválido. Deve ser 'date_created'.

invalid_range_begin_date

A data de início do intervalo é inválida ou não foi informada quando o parâmetro 'range' foi utilizado como filtro de busca. É obrigatório enviá-lo nesses casos.

invalid_range_end_date

A data de fim do intervalo é inválida ou não foi informada quando o parâmetro 'range' foi utilizado como filtro de busca. É obrigatório enviá-lo nesses casos.

invalid_account_id

O valor informado para o parâmetro 'account_id' é inválido. Valida se a informação enviada é correta e tenta novamente.

invalid_currency_id

O valor informado para o parâmetro 'currency_id' é inválido. Deve conter apenas letras maiúsculas e um máximo de 10 caracteres.

invalid_filters

Os filtros contêm campos inválidos. Revise a documentação do parâmetro 'filters' para obter mais informações.

invalid_alias_created_from

O valor informado para o parâmetro 'alias_created_from' é inválido. Deve ser 'manual' ou 'schedule'.

401Unauthorized.

unauthorized_user_id

O usuário não está autorizado a acessar o recurso solicitado. Valida se a informação enviada é correta e tenta novamente.

500Erro interno do servidor.

internal_error

Erro interno do servidor. Aguarda alguns minutos e tenta novamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/account/release_report/search?id=17001104&file_name=release-report-238792004-2025-07-15-050017.csv&begin_date=2025-08-01T00:00:00Z&end_date=2025-08-05T23:59:59Z&created_from=manual&range=date_created&range_begin_date=2025-07-01T00:00:00Z&range_end_date=2025-07-31T23:59:59Z&account_id=208361929&currency_id=ARS&format=CSV&limit=30'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    
Response
{
  "paging": {
    "total": 4,
    "limit": 30,
    "offset": 0
  },
  "results": [
    {
      "id": 17001104,
      "user_id": 574264905,
      "begin_date": "2022-09-30T03:00:00Z",
      "end_date": "2022-10-02T02:59:59Z",
      "file_name": "release-report-USER_ID-2022-10-12-104118.csv",
      "created_from": "manual",
      "date_created": "2022-10-12T10:41:19.000-04:00",
      "download_date": "2022-10-12T10:42:55.000-04:00",
      "status": "enabled",
      "origin": "date_range",
      "sub_type": "release",
      "metadata": "{\"user_tags\": [\"normal\", \"credits_profile\", \"messages_as_seller\"], \"generation_model\": \"release\", \"last_movement_id\": 129309876619}",
      "model": "release",
      "account_id": 208361929,
      "currency_id": "ARS",
      "format": "CSV"
    }
  ]
}