Search orders - Merchant Orders - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Search orders

GET

https://api.mercadopago.com/merchant_orders/search
Find all the information of the orders generated through specific filters or a specific date range.
Request's parameters
QUERY
status
string
Merchant order state.
preference_id
string
Payment preference identifier associated to the merchant order.
application_id
string
application identifier.
payer_id
string
Payer ID.
Response parameters
elements
array
Contains the order data.
next_offset
number
Numeric field used to paginate the response.
total
number
Total search results.
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-8971*********918-01191*********5874530a4*********4799fdf-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
}