Buscar em pedidos - Pedidos comerciais - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos
Buscar em pedidos

GET

https://api.mercadopago.com/merchant_orders/search
Encontre todas as informações dos pedidos gerados através de filtros específicos ou por um intervalo de datas específico.
Parâmetros de requisição
QUERY
status
string
Status do pedido.
preference_id
string
Identificação da preferência de pagamento associados à ordem
application_id
string
Id do aplicativo
payer_id
string
Identificador de pagador
Parâmetros de resposta
elements
array
Contém os dados do pedido.
next_offset
number
Campo numérico usado para paginar a resposta.
total
number
Total de resultados da pesquisa.
Erros

400Erro

ds_search_query

invalid query.

401Erro

invalid_token

invalid_token.

invalid_caller_id

invalid caller_id

Requisição
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-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    
Resposta de exemplo
{
  "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
}