Este endpoint permite buscar orders de forma masiva, utilizando diversos filtros y información de paginación. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
GET
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
missing_required_params
Los parámetros "begin_date" y "end_date" están faltando. Estos parámetros son obligatorios para la consulta.
invalid_parameter
Se envió un valor inválido para un parámetro de consulta. Esto puede ocurrir con formatos de fecha inválidos (debe usar formato RFC3339, ej.: '2023-01-01T00:00:00Z'), valores de paginación inválidos ("page" e "page_size"), valores de ordenamiento inválidos ("sort_by", "sort_order") o valores de filtro inválidos ("status", "type", "payment_method_id", etc.). Consulta los detalles del mensaje de error para información específica.
401Error. Access Token no autorizado.
401
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Use usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y sus credenciales de producción para el entorno de producción.
500Error genérico.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X GET \
'https://api.mercadopago.com/v1/orders?begin_date=2025-11-01T00:00:00.000Z&end_date=2025-11-11T23:59:59.999Z&external_reference=ext_ref_1234&type=online&status=processed&status_detail=accredited&payment_method_id=pix&payment_method_type=credit_card&page=1&page_size=20&sort_by=created_date&sort_order=desc'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
{
"data": [
{
"id": "ORD01K9SN1Q5959CGN8QGW00EH7V5",
"type": "online",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"total_paid_amount": "50.00",
"user_id": "12345",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic_async",
"currency": "BRL",
"created_date": "2024-08-26T13:06:51.045317772Z",
"last_updated_date": "2024-08-26T13:06:51.045317772Z",
"integration_data": {
"application_id": "1234",
"integrator_id": "dev_123",
"platform_id": "1234567890",
"sponsor": {
"id": "446566691"
}
},
"transactions": {
"payments": [
{
"id": "PAY01K9SN1Q5959CGN8QGW176BB6P",
"amount": "24.50",
"paid_amount": "50.00",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "pix",
"type": "credit_card",
"installments": 1,
"transaction_security": {
"validation": "on_fraud_risk",
"liability_shift": "required",
"url": "https://www.mercadopago.com/auth/card/validation/pages/remedies/019ada0a-fe1f-7a82-ba1a-1ccb4e0232e7?display_mode=self_hosted&guest_token=0661345a-e0e1-4c09-aff9-b7929ca9a24a",
"id": "019ada0a-fe1f-7a82-ba1a-1ccb4e0232e7",
"type": "three_ds",
"status": "NOT_AUTHENTICATED"
}
}
}
]
}
}
],
"paging": {
"total": "54",
"total_pages": "3",
"offset": "0",
"limit": "20"
}
}