Get order by IDhttps://api.mercadopago.com/v1/orders/{order_id}
Consult all order information using the ID obtained in the response to its creation, as long as it was created less than 3 months ago. In case of success, the request will return a response with status 200
GET
Request 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 created in the request, automatically generated by Mercado Pago.string
user_id
ID of the Mercado Pago account that created the order.string
type
Order type.string
point: Order created for Mercado Pago Point payments.
external_reference
It is the external reference of the order, assigned when creating it. he maximum allowed limit is 64 characters, and the allowed characters are: uppercase and lowercase letters, numbers, and the symbols hyphen (-) and un...View morestring
Errors
400Error.
bad_request
The order_id provided in the request path is not correct. 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
Order not found. Please check if you provided the correct order ID.
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 APP_USR-7*********635832-03*********2ffa6c013*********0a90fa2cd*********120' \
Response
{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"description": "Smartphone",
"country_code": "CHL",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
},
"status": "refunded",
"status_detail": "refunded",
"created_date": "2024-09-10T14:26:42.109320977Z",
"last_updated_date": "2024-09-10T14:26:42.109320977Z",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__N950NCB801293324",
"print_on_terminal": "no_ticket",
"ticket_number": "S0392JED"
},
"payment_method": {
"default_type": "credit_card",
"default_installments": "6"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24",
"refunded_amount": "38",
"tip_amount": "14",
"paid_amount": "38",
"status": "refunded",
"status_detail": "created",
"reference_id": "12345678",
"payment_method": {
"type": "credit_card",
"installments": 1,
"id": "master"
},
"card": {
"first_digits": "credit_card",
"last_digits": "credit_card"
}
}
],
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"reference_id": "12345678",
"amount": "47",
"status": "processed"
}
]
},
"taxes": [
{
"payer_condition": "payment_taxable_iva"
}
]
}