Get order by shipment ID

GET

/proximity-integration/v1/orders/{shipment_id}
Retrieve the information of an order by its shipment ID.
Request's parameters
shipment_id

REQUIRED

string
Localization: pathShipment ID of the order.
x-time-zone

REQUIRED

string
Localization: headerTimezone of the times shown on the JSON. For example: GMT-3.
Response parameters
id
string
Localization: bodyShipment ID of the order.
type
string
Localization: bodyThis field refers to the way in which the order will be delivered.
DELIVERY: the restaurant will be responsible for delivering the order.
TAKEOUT: the buyer will pick up the order from the restaurant.
displayId
string
Localization: bodyOrder Id shown in the Ordering Application interface for the Buyer.
createdAt
string
Localization: bodyOrder creation time.
Request
curl
curl -X GET \
      'https://api.mercadopago.com/proximity-integration/v1/orders/{shipment_id}' \
       -H 'Authorization: Bearer YOUR_ACCESS_TOKEN \
      
Answer
json
{
  "id": "41034141533",
  "type": "DELIVERY",
  "displayId": "9129",
  "createdAt": "2022-02-16T21:20:15.227Z",
  "orderTiming": "INSTANT",
  "preparationStartDateTime": "2022-02-16T21:20:47.755Z",
  "merchant": {
    "id": "1070421029",
    "name": "Doc's Store"
  },
  "items": [
    {
      "id": "MLA1122759502",
      "name": "Burrito Combo Refrigerante",
      "externalCode": "1215451",
      "unit": "UNIT",
      "quantity": 2,
      "specialInstructions": "No quiero cebolla.",
      "options": [
        {
          "id": "MLA1122707065",
          "name": "Soda",
          "externalCode": "151545",
          "unit": "UNIT",
          "quantity": 2,
          "unitPrice": {
            "value": 100,
            "currency": "ARS"
          },
          "totalPrice": {
            "value": 200,
            "currency": "ARS"
          },
          "extension": {
            "group": "Combo with soda"
          }
        }
      ],
      "unitPrice": {
        "value": 300,
        "currency": "ARS"
      },
      "optionsPrice": {
        "value": 200,
        "currency": "ARS"
      },
      "totalPrice": {
        "value": 1000,
        "currency": "ARS"
      },
      "extension": {
        "unitNetPrice": {
          "value": 1000,
          "currency": "ARS"
        }
      }
    }
  ],
  "otherFees": [
    {
      "name": "Name of the Fee",
      "type": "DELIVERY_FEE",
      "receivedBy": "MERCHANT",
      "receiverDocument": "3124123141",
      "price": {
        "value": 119,
        "currency": "ARS"
      }
    }
  ],
  "discounts": [
    {
      "amount": {
        "value": 119,
        "currency": "ARS"
      },
      "target": "ITEM",
      "targetId": "MLA1122759502",
      "sponsorshipValues": [
        {
          "name": "MARKETPLACE",
          "amount": {
            "value": 119,
            "currency": "ARS"
          }
        }
      ],
      "extension": {
        "id": "21515164-001",
        "name": "coupon_off"
      }
    }
  ],
  "total": {
    "itemsPrice": {
      "value": 1000,
      "currency": "ARS"
    },
    "otherFees": {
      "value": 119,
      "currency": "ARS"
    },
    "discount": {
      "value": 0,
      "currency": "ARS"
    },
    "orderAmount": {
      "value": 1119,
      "currency": "ARS"
    }
  },
  "payments": {
    "prepaid": 1119,
    "pending": 0,
    "methods": [
      {
        "currency": "ARS",
        "type": "PREPAID",
        "method": "DIGITAL_WALLET"
      }
    ]
  },
  "customer": {
    "id": "1071059933",
    "name": "Test User",
    "phone": {
      "number": "011 123456789"
    },
    "documentNumber": "2731234567894"
  },
  "delivery": {
    "deliveredBy": "MERCHANT",
    "deliveryAddress": {
      "country": "Argetina",
      "state": "Capital Federal",
      "city": "Santos Lugares",
      "streetName": "Calle 01",
      "streetNumber": "1523",
      "complement": "APTO 58",
      "reference": "Referencia: Next to bakery",
      "formattedAddress": "Calle 01 1523",
      "postalCode": "1428",
      "coordinates": {
        "latitude": -34.55864,
        "longitude": -58.457982
      }
    },
    "estimatedDeliveryDateTime": "2022-02-21T21:49:55Z",
    "deliveryDateTime": "2022-02-21T21:52:55Z"
  },
  "extension": {
    "status": "ready_to_ship",
    "substatus": "printed",
    "store": {
      "id": "44905357",
      "externalCode": "UNID01",
      "brandId": 2641,
      "brandName": "Brand Name"
    },
    "qr": {
      "id": "41382089428",
      "sender_id": 1068595961,
      "hash_code": "v3Xtt15eewkj3Eu2lZt+cJQgDj3H6AHb04y1cMO4nPI=",
      "security_digit": "0"
    },
    "estimatedPickupDate": "2022-02-21T22:00:55Z",
    "paymentsInfo": [
      {
        "id": 58096990331,
        "entity": "ORDER",
        "entityId": 2000005654919550
      }
    ]
  }
}
Errors
401bad_request
401 Unauthorized - Access Token is invalid
403bad_request
403 Forbidden - User cannot access this resource
404bad_request
404 Not Found - Failed to search shipment
424bad_request
424 Not Found - Failed to get some information of the order
500bad_request
500 Internal server error