This endpoint allows to search for orders in a massive way, using various filters and pagination information. In case of success, the request will return a response with status 200.
GET
REQUIRED
REQUIRED
REQUIRED
400Request error.
missing_required_params
The "begin_date" and "end_date" parameters are missing. These parameters are mandatory for the search.
invalid_parameter
An invalid value was sent for a query parameter. This can occur with invalid date formats (must use RFC3339 format, e.g.: "2023-01-01T00:00:00Z"), invalid pagination values ("offset" and "limit"), or invalid filter values ("status", "external_reference"). Check the error message details for specific information.
401Error. Access Token not authorized.
401
The value sent as Access Token is incorrect. Please check and try again with the correct value.
invalid_credentials
There is no support for test credentials. Use test users with production credentials for the sandbox environment and your production credentials for the production environment.
500Generic error.
internal_error
Generic error. Please try submitting the request again.
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": "COP",
"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": "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": "NOT_AUTHENTICATED"
}
}
}
]
}
}
],
"paging": {
"total": "54",
"total_pages": "3",
"offset": "0",
"limit": "20"
}
}