Get order by IDhttps://api.mercadopago.com/v1/orders/{id}
Consult all order information using the ID obtained in the response to its creation. In case of success, the request will return a response with status 200.
GET
Request parameters
Header
Authorization
Access Token obtained through the developer panel. Must be sent in all requests.string
REQUIRED
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 ...Show morestring
REQUIRED
total_amount
Total amount to be paid.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.
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.
404Error. Order not found.
order_not_found
Order not found. Please check if you provided the correct order ID.
500Generic error.
internal_error
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 APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
Response
{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"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": "AR",
"type": "online",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic_async",
"total_paid_amount": "50.00",
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"paid_amount": "50.00",
"date_of_expiration": "2023-03-01T10:00:00.000-04:00",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "rapipago",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store",
"ticket_url": "https://www.mercadopago.com.ar/payments/86797024510/ticket?caller_id=1870026883&payment_method_id=rapipago&payment_id=86797024510&payment_method_reference_id=6004835002&hash=0331521a-9ddb-44a2-851c-65f77d8d394e",
"barcode_content": "3335008800000000006004835002100020000242462010",
"reference": "6005407530",
"verification_code": "6005407530",
"financial_institution": "bradesco"
}
}
],
"chargebacks": [
{
"id": "CBK01J67CQQH5904WDBVZEM4JMEP3",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"case_id": "1234567890",
"status": "in_process",
"references": [
{}
]
}
]
},
"description": "Smartphone",
"items": [
{
"title": "Smartphone",
"unit_price": "24.50",
"quantity": 4,
"description": "Smartphone",
"external_code": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055",
"type": "MLB1055",
"warranty": "true",
"event_date": "2014-06-28T16:53:03.176-04:00"
}
],
"expiration_time": "P3Y6M4DT12H30M5S",
"client_token": "QWERTY12345.ASDFG67890",
"config": {
"payment_method": {
"default_type": "credit_card",
"installments_cost": "seller",
"installments": {
"interest_free": {
"type": "range",
"values": [
{}
]
},
"available": {
"type": "all"
}
}
}
}
}