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
Errores
Cada respuesta de la API incluye un código de estado HTTP que indica el resultado de la solicitud. El código 200 indica que la operación fue exitosa, el 400 señala un error en los datos enviados y el 500 indica un error interno del servidor.
Algunos errores 400 pueden gestionarse de forma programática e incluyen un código que describe la causa del error.
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=master&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-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
{
"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",
"currency": "MXN",
"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": "<YOUR_SPONSOR_ID>"
}
},
"transactions": {
"payments": [
{
"id": "PAY01K9SN1Q5959CGN8QGW176BB6P",
"amount": "24.50",
"paid_amount": "47.28",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "master",
"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": "AUTHENTICATED"
}
}
}
]
}
}
],
"paging": {
"total": "54",
"total_pages": "3",
"offset": "0",
"limit": "20"
}
}