Search orders
GET
Products that use it:
Request's parameters
QUERY
status
Merchant order state.string
preference_id
Payment preference identifier associated to the merchant order.string
application_id
application identifier.string
payer_id
Payer ID.string
Response parameters
elements
Contains the order data.array
next_offset
Numeric field used to paginate the response.number
total
Total search results.number
Errors
400Error
ds_search_query
invalid query.
401Error
invalid_token
invalid_token.
invalid_caller_id
invalid caller_id
Request
curl -X GET \
'https://api.mercadopago.com/merchant_orders/search?status=12123adfasdf123u4u&preference_id=12123adfasdf123u4u&application_id=12123adfasdf123u4u&payer_id=12123adfasdf123u4u&sponsor_id=12123adfasdf123u4u&external_reference=12123adfasdf123u4u&site_id=12123adfasdf123u4u&marketplace=12123adfasdf123u4u&date_created_from=12123adfasdf123u4u&date_created_to=12123adfasdf123u4u&last_updated_from=12123adfasdf123u4u&last_updated_to=12123adfasdf123u4u&items=12123adfasdf123u4u&limit=12123adfasdf123u4u&offset=12123adfasdf123u4u'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
Sample answer
{
"elements": [
{
"id": 9999999999,
"status": "closed",
"external_reference": "default",
"preference_id": "Preference identification",
"payments": [
{
"id": 9999999999,
"transaction_amount": 1,
"total_paid_amount": 1,
"shipping_cost": 0,
"currency_id": "BRL",
"status": "approved",
"status_detail": "accredited",
"date_approved": "2019-04-02T18:35:35.000Z",
"date_created": "2019-04-02T18:35:34.000Z",
"last_modified": "2019-04-02T18:35:35.000Z",
"amount_refunded": 0
}
],
"shipments": [
{
"id": 99999999999,
"shipment_type": "shipping",
"shipping_mode": "me2",
"status": "delivered",
"items": [
{
"id": "not specified",
"description": "shipment item description",
"quantity": 1,
"dimensions": "1.0x10.0x23.0100.0"
}
],
"date_created": "2019-04-02T18:20:46.000Z",
"last_modified": "2019-04-12T19:36:48.000Z",
"date_first_printed": "2019-04-02T18:35:40.000Z",
"service_id": 999,
"sender_id": 999999999,
"receiver_id": 999999999,
"receiver_address": {
"id": 9999999999,
"address_line": "address line",
"city": {
"name": "City Name"
},
"state": {
"id": "AR-X",
"name": "state name"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": 0,
"longitude": 0,
"comment": "shipment comment",
"contact": "shipment contact",
"phone": 9999999999,
"zip_code": 9999,
"street_name": {
"en": "Street name",
"pt": "Nome da rua",
"es": "Nombre de la calle"
},
"street_number": 999
},
"shipping_option": {
"id": 999999999,
"cost": 0,
"currency_id": "BRL",
"shipping_method_id": 99999,
"estimated_delivery": {
"date": "2019-04-11T03:00:00.000Z"
},
"name": "Normal a domicilio",
"list_cost": 0,
"speed": {
"handling": 72,
"shipping": 72
}
}
}
],
"collector": {
"id": 999999999
},
"marketplace": "NONE",
"date_created": "2018-09-14T17:11:31.000Z",
"last_updated": "2018-09-14T17:11:43.000Z",
"shipping_cost": 0,
"total_amount": 5,
"site_id": "MLA",
"paid_amount": 5,
"refunded_amount": 0,
"payer": {
"id": 999999999
},
"items": [
{
"id": "item id",
"category_id": "item category",
"currency_id": "BRL",
"description": "item description",
"picture_url": "item picture url",
"title": "item title",
"quantity": 1,
"unit_price": 5
}
],
"additional_info": "additional information",
"application_id": "10000000000000000",
"order_status": "paid"
}
],
"next_offset": 1,
"total": 1
}