Get order by ID
GET
Products that use it:
Request's parameters
PATH
order_id
Order ID returned in the response to the request made for its creation.string
REQUIRED
Response parameters
id
Identifier of the order whose information is being consulted, automatically generated by Mercado Pago.string
user_id
ID of the Mercado Pago account that created the order.string
type
Order type.string
qr: Order created for Mercado Pago QR Code payments.
external_reference
It is the external reference of the order, assigned when creating it. string
Errors
400Error.
invalid_path_param
The Order ID provided in the request path has has an invalid format. It must begin with the prefix "ORD" and be followed by 26 characters. Please confirm it and provide a valid ID to try again.
401Error.
unauthorized
The value sent as Access Token is incorrect. Please check and try again with the correct value.
404Error.
order_not_found
The value sent as Order ID does not correspond to a created order, therefore it could not be found. Please check and try again with the correct value.
500Error.
500
Internal server error. Please try submitting the request again.
Request
curl -X GET \
'https://api.mercadopago.com/v1/orders/{order_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
Sample answer
{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "qr",
"external_reference": "ext_ref_1234",
"description": "Point Mini",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"total_amount": "50.00",
"country_code": "CHL",
"marketplace_fee": "11.22",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_1234",
"sponsor": {
"id": "446566691"
}
},
"status": "refunded",
"status_detail": "created",
"created_date": "2024-09-10T14:26:42.109Z",
"last_updated_date": "2024-09-10T14:27:42.109Z",
"config": {
"qr": {
"external_pos_id": "EXTERNALPOS019285",
"mode": "static"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "50.00",
"refunded_amount": "47.28",
"paid_amount": "47.28",
"status": "refunded",
"status_detail": "refunded",
"reference_id": "12345678",
"payment_method": {
"type": "credit_card",
"installments": 1,
"id": "master"
},
"discounts": {
"type": "account_money"
}
}
],
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"reference_id": "12345678",
"amount": "47.28",
"status": "processed"
}
]
},
"taxes": [
{}
],
"items": [
{
"title": "Point New Land",
"unit_price": "50.00",
"quantity": 1,
"unit_measure": "kg",
"external_code": "777489134",
"external_categories": [
{
"id": "food"
}
]
}
],
"discounts": {
"payment_methods": [
{
"new_total_amount": "47.28",
"type": "account_money"
}
]
}
}