Este endpoint permite buscar y filtrar reportes de Todas las transacciones. Proporciona capacidades de paginación y filtrado para obtener resultados según diversos criterios. En caso de éxito, la solicitud devolverá una respuesta con estado 200.
GET
REQUERIDO
400Bad Request. Parámetros inválidos en la solicitud.
invalid_id
El valor informado para el 'id' del reporte es inválido. Valida si la información enviada es correcta y vuelve a intentarlo.
invalid_offset
El offset no es válido o excede el valor máximo de 10000. Valida si la información enviada es correcta y vuelve a intentarlo.
invalid_limit
El lÃmite no es válido o excede el valor máximo de 500. Valida si la información enviada es correcta y vuelve a intentarlo.
invalid_range
El valor informado para el parámetro 'range' es inválido. Debe ser 'date_created'.
invalid_range_begin_date
La fecha de inicio de rango es inválida o no se informó al haber utilizado el parámetro 'range' como filtro de búsqueda. Es obligatorio enviarlo en estos casos.
invalid_range_end_date
La fecha de fin de rango es inválida o no se informó al haber utilizado el parámetro 'range' como filtro de búsqueda. Es obligatorio enviarlo en estos casos.
invalid_account_id
El valor informado para el parámetro 'account_id' es inválido. Valida si la información enviada es correcta y vuelve a intentarlo.
invalid_currency_id
El valor informado para el parámetro 'currency_id' es inválido. Debe contener solo letras mayúsculas y un máximo de 10 caracteres.
invalid_filters
Los filtros contienen campos no válidos. Revisa la documentación del parámetro 'filters' para obtener más información.
invalid_alias_created_from
El valor informado para el parámetro 'alias_created_from' es inválido. Debe ser 'manual' o 'schedule'.
401Unauthorized.
unauthorized_user_id
El usuario no está autorizado para acceder al recurso solicitado. Valida si la información enviada es correcta y vuelve a intentarlo.
500Error interno del servidor.
internal_error
Error interno del servidor. Aguarda unos minutos y vuelve a intentarlo.
curl -X GET \
'https://api.mercadopago.com/v1/account/settlement_report/search?id=17001104&file_name=settlement-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¤cy_id=ARS&format=CSV&limit=30'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
{
"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": "settlement-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": "processed",
"origin": "date_range",
"sub_type": null,
"metadata": "{\"user_tags\": [\"normal\", \"credits_profile\", \"messages_as_seller\"], \"generation_model\": \"settlement\", \"last_movement_id\": 129309876619}",
"model": "settlement",
"account_id": 208361929,
"currency_id": "ARS",
"format": "CSV"
}
]
}