Intelligent search powered by OpenAI
Get order by ID
GET
Products that use it:
Request's parameters
PATH
id
Order ID, returned in the response to the request made for its creation.string
REQUIRED
Response parameters
id
Identifier of the order created in the request, automatically generated by Mercado Pago.string
processing_mode
Order processing modestring
manual: Order's processing will be made manually. It is the processing mode used for the "manual" option, as it sets the processing to be made afterwards, by using the "Process order by ID" endpoint.
automatic: Order's processing will be made instantly. It is the capture mode used for the "automatic" option.
external_reference
It is an external reference of the order. It can be, for example, a hashcode from the Central Bank, functioning as an identifier of the transaction origin. This field must have a maximum of 64 characters and can only be ...View morestring
REQUIRED
total_amount
Total amount to be paid. It must be sent with two decimals.string
Errors
400Error. Invalid ID supplied
invalid_path_param
The order_id provided in the request path is not correct. Please confirm it and provide a valid ID to try again.
401Error. Access Token not authorized.
401
The value sent as Access Token is incorrect. Please check and try again with the correct value.
404Error. Order not found.
order_not_found
Order not found. Please check if you provided the correct order ID.
500Generic error .
500
Generic error. Please try submitting the request again.
Request
curl -X GET \
'https://api.mercadopago.com/v1/orders/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
Sample answer
{
"id": "123",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "24.90",
"integration_data": {
"application_id": "1234",
"integrator_id": "dev_123",
"platform_id": "1234567890",
"sponsor": {
"id": "446566691"
}
},
"user_id": "12345",
"created_date": "2024-08-26T13:06:51.045317772Z",
"last_updated_date": "2024-08-26T13:06:51.045317772Z",
"country_code": "BRA",
"type": "online",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "manual",
"transactions": {
"payments": [
{
"id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.90",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "visa",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "approved"
}
}
]
},
"description": "Point Mini",
"marketplace": "MERCADOLIVRE",
"items": [
{
"title": "Point Mini",
"unit_price": "12.90",
"quantity": 4,
"description": "Point product for card payments via Bluetooth.",
"id": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055"
}
],
"expiration_time": "P3Y6M4DT12H30M5S"
}