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
begin_date y end_date debe ser de 30 días (720 horas) como máximo. Además, la fecha inicial no puede estar en el futuro nREQUERIDO
begin_date y end_date debe ser de 30 días (720 horas) como máximo. Además, la fecha final no puede tener más de 5 años de a400Error 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), rangos de fechas inválidos (intervalo entre begin_date y end_date mayor que 30 días, begin_date en el futuro o posterior a end_date, o end_date de hace más de 5 años), valores de paginación inválidos (offset y limit) o valores de filtro inválidos (status, external_reference). Consulta los detalles del mensaje de error para información específica. Por ejemplo, un intervalo mayor que 30 días devuelve el detalle date range: maximum allowed is 1 month. El límite es de 30 días fijos, no de un mes calendario.
401Error. Access Token no autorizado.
401
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la solicitud enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Utiliza 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.
403Error. Prohibido.
forbidden
La aplicación no tiene permisos para acceder a este recurso. Verifica que el Access Token utilizado tenga los permisos y scopes necesarios para esta operación.
PA_UNAUTHORIZED_RESULT_FROM_POLICIES
La cuenta está bloqueada y sus claves de API fueron revocadas. Al menos una política evaluada por el Policy Agent retornó un resultado no autorizado.
429Límite de solicitudes excedido.
too_many_requests
Client ID bloqueado por el gateway porque se alcanzó el límite de solicitudes para el ID en cuestión. Lee el header Retry-After de la respuesta y espera la cantidad de segundos indicada antes de volver a intentarlo. Para mayor resiliencia, implementa backoff exponencial con jitter, es decir, aumenta el tiempo de espera en cada nuevo intento y añade una variación aleatoria para evitar el reenvío simultáneo de muchas solicitudes.
usage_quota_exceeded
Cuota impuesta por el backend de la API porque se alcanzó el límite de solicitudes por cliente. Lee el header Retry-After de la respuesta y espera la cantidad de segundos indicada antes de volver a intentarlo. Para mayor resiliencia, implementa backoff exponencial con jitter, es decir, aumenta el tiempo de espera en cada nuevo intento y añade una variación aleatoria para evitar el reenvío simultáneo de muchas solicitudes.
500Error genérico.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X GET \
'https://api.mercadopago.com/v1/orders?begin_date=2026-06-01T00:00:00Z&end_date=2026-06-03T00:00:00Z&external_reference=ORDER-1234&status=processed&limit=10'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ' \
{
"data": [
{
"id": "ORD01K9SN1Q5959CGN8QGW00EH7V5",
"type": "online",
"processing_mode": "manual",
"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": "visa",
"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"
}
}