Search for orders - Merchant Orders - Mercado Pago Developers
Developers
API Reference
Support
Sign in

    Start

    LISTA DE API

    Preferences

    Create a preference

    POST

    Search preferences

    GET

    Get a preference

    GET

    Update a preference

    PUT

    Identification Types

    Get document types

    GET

    Payment Methods

    Get the payment methods

    GET

    Payments

    Create payments

    POST

    Find payments

    GET

    Get a payment

    GET

    Update a payment

    PUT

    Chargebacks

    Get a chargeback

    GET

    Customers

    Create a customer

    POST

    Search for a customer

    GET

    Get a customer

    GET

    Update a customer

    PUT

    Cards

    Save a card

    POST

    Obtain customer cards

    GET

    Get a card

    GET

    Update a card

    PUT

    Delete a card

    DELETE

    Stores

    Get a Store

    GET

    Create a Store

    POST

    Search stores

    GET

    Update a Store

    PUT

    Delete a Store

    DELETE

    Point of Sale

    Create a POS

    POST

    Get all POS

    GET

    Get a POS

    GET

    Update a POS

    PUT

    Delete a POS

    DELETE

    Instore Orders

    Create an order

    POST

    Delete an order

    DELETE

    Instore Orders v2

    Create an order

    PUT

    Get an order

    GET

    Delete an order

    DELETE

    Merchant Orders

    Create an order

    POST

    Search for orders

    GET

    Get an order

    GET

    Update an order

    PUT

    Subscription Preferences

    Create a subscription

    POST

Search for orders

GET

/merchant_orders/search
Find all the information of the orders generated through specific filters or a specific date range.
Products that use it:
Checkout Pro
Marketplace
QR Code
Request's parameters
status

REQUIRED

string
Localization: queryMerchant order state
preference_id

REQUIRED

string
Localization: queryPayment preference identifier associated to the merchant order
application_id

REQUIRED

string
Localization: queryapplication identifier
payer_id

REQUIRED

string
Localization: queryBuyer's Id
Response parameters
elements
array
Localization: bodyelements
next_offset
number
Localization: bodynext_offset
total
number
Localization: bodytotal
Request
curl
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 'Authorization: Bearer ACCESS_TOKEN_ENV' 
Answer
json
{
  "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": "Street name",
            "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
}
Errors
400bad_request
ds_search_queryinvalid query.
401bad_request
invalid_tokeninvalid_token.
invalid_caller_idinvalid caller_id
Was this information helpful?

© 2021 MercadoLibre S.R.L.

Terms and conditionsHow we protect your privacy
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.