Sales

An order is a request a customer places on a listed item with the intention to purchase it under a series of conditions choosed throughout the checkout flow. These conditions are detailed on the order that will be replicated for the buyer and the seller accounts as well. On the order you'll find a lot of information to fill out about your product and you'll be able to reserve and/or subtract stock. Learn more about the flow to manage simple and cart orders, payments and shipments.

References
A - Receive notification and obtain specific information about the order
B - Verify the existence of tag "pack_order" in the order
C - Check if the order has an associated shipment
D - Obtain the shipping items (they may correspond to different orders)
E - Validate the order quantity of the shipment
F - Get the information of the orders associated with the shipment
G - Get shipping information


Contents

→Receive an order →Fraud alerts (stop shipping) →Total_amount_with_shipping calculation
→Search orders →Products information in orders →Filter orders →Sort orders →Recent orders →Archived orders →Pending orders →Mercado Shops orders →Get Mercado Shops orders →Order status →Error code reference →HTTP response code references


Receive an order

Important:
Consult the buyer's billing info data by performing a GET to / orders / billing_inf.

Once a new order is created on your user, you can check its details by making a request to the order resource:
Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2032217210

Response:

{
  "application_id": "7092",
  "buyer": {
    "alternative_phone": {
      "area_code": "41",
      "extension": "",
      "number": "30576339"
    },
    "email": "vschemb.y14cdz+2-ogiydgmrsge3tenbz@mail.mercadolivre.com",
    "first_name": "Victor Hugo",
    "id": 89660613,
    "last_name": "Schemberger",
    "nickname": "S.VICTORHUGO",
    "phone": {
      "area_code": "41",
      "extension": "",
      "number": "99962663",
      "verified": false
    }
  },
  "buying_mode": "buy_equals_pay",
  "comments": null,
  "coupon": {
    "amount": 0,
    "id": null
  },
  "currency_id": "BRL",
  "date_closed": "2019-05-22T03:51:07.000-04:00",
  "date_created": "2019-05-22T03:51:05.000-04:00",
  "expiration_date": "2019-06-19T03:51:07.000-04:00",
  "feedback": {
    "purchase": null,
    "sale": null
  },
  "fulfilled": true,
  "hidden_for_seller": false,
  "id": 2032217210,
  "internal_tags": [],
  "last_updated": "2019-05-28T15:16:04.000-04:00",
  "manufacturing_ending_date": null,
  "mediations": [],
  "order_items": [
    {
      "base_currency_id": null,
      "base_exchange_rate": null,
      "currency_id": "BRL",
      "differential_pricing_id": null,
      "full_unit_price": 129.95,
      "item": {
        "category_id": "MLB33383",
        "condition": "new",
        "id": "MLB1054990648",
        "seller_custom_field": null,
        "seller_sku": null,
        "title": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g",
        "variation_attributes": [],
        "variation_id": null,
        "warranty": "Garantia de 1 ano fabricante"
      },
      "listing_type_id": "gold_special",
      "manufacturing_days": null,
      "quantity": 1,
      "sale_fee": 14.29,
      "unit_price": 129.95
    }
  ],
  "order_request": {
    "change": null,
    "return": null
  },
  "pack_id": null,
  "paid_amount": 129.95,
  "payments": [
    {
      "activation_uri": null,
      "atm_transfer_reference": {
        "company_id": null,
        "transaction_id": "135292"
      },
      "authorization_code": "008877",
      "available_actions": [
        "refund"
      ],
      "card_id": 203453778,
      "collector": {
        "id": 239432672
      },
      "coupon_amount": 0,
      "coupon_id": null,
      "currency_id": "BRL",
      "date_approved": "2019-05-22T03:51:07.000-04:00",
      "date_created": "2019-05-22T03:51:05.000-04:00",
      "date_last_modified": "2019-05-22T03:51:07.000-04:00",
      "deferred_period": null,
      "id": 4792155710,
      "installment_amount": 129.95,
      "installments": 1,
      "issuer_id": "24",
      "marketplace_fee": 14.290000000000001,
      "operation_type": "regular_payment",
      "order_id": 2032217210,
      "overpaid_amount": 0,
      "payer_id": 89660613,
      "payment_method_id": "master",
      "payment_type": "credit_card",
      "reason": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g",
      "shipping_cost": 0,
      "site_id": "MLB",
      "status": "approved",
      "status_code": null,
      "status_detail": "accredited",
      "taxes_amount": 0,
      "total_paid_amount": 129.95,
      "transaction_amount": 129.95,
      "transaction_order_id": null
    }
  ],
  "pickup_id": null,
  "seller": {
    "alternative_phone": {
      "area_code": "",
      "extension": "",
      "number": ""
    },
    "email": "dcherac.8m6k0q+2-ogiydgmrsge3tenby@mail.mercadolivre.com",
    "first_name": "Demétrio",
    "id": 239432672,
    "last_name": "Cheracomo",
    "nickname": "VENDASDKMB",
    "phone": {
      "area_code": null,
      "extension": "",
      "number": "11971427863",
      "verified": false
    }
  },
  "shipping": {
    "id": 27968238880
  },
  "shipping_cost": 0,
  "status": "paid",
  "status_detail": null,
  "tags": [
    "delivered",
    "paid"
  ],
  "taxes": {
    "amount": null,
    "currency_id": null
  },
  "total_amount": 129.95
}

Orders have a lot of attributes. Below you will see a description of the most important fields.
id: unique order identifier.
date_created: order creation date.
date_closed: order confirmation date. It is set when an order status changes for the first time to confirmed / paid and the item is subtracted from the stock.
expiration_date: this is the deadline for the user to qualify since, after that date, the feedback is made visible, payments are released (if any), and charges are created.
status: order status. See possible values.
status_detail: status detail.
code: status code.
description: status description.
buyer: buyer's information.
seller: seller's information.
order_items: order item listings.

  • item: specific listing.
  • quantity: quantity of items purchased.
  • sale_fee: sales commission.
  • unit_price: price per item.

payments: order-related payments.
feedback: order-related feedback information.
shipping: shipping configuration for this order.
total_amount: total invoice amount.
currency_id: currency ID.
tags: list of seller selected tags, such as delivered, paid.
taxes: amount with the sum of taxes to be paid from the order.
cancel_detail. detail of the cancellation of the order in which it is found.

  • group: logical grouping of cancellation (mediations, fiscal, buyer, fraud, item, shipment, delivery, seller, internal).
  • code: cancellation cause code.
  • description: description of the cause of cancellation.
  • requested_by: who requests the cancellation (buyer, seller, Mercado Libre).
  • date: cancellation date.
  • application_id: ID of the application requesting cancellation.

Notes:
- Remember that charges are calculated at the time of payment accreditation, that is, when the order becomes visible to the seller and not when the order is created.
- As it happens every time the information of an order is updated, if we discover a fraudulent purchase, we will place the fraud_risk_detected tag to the order and send you a notification with the topic "orders" and said order ID.
To get more shipping information, you have to request to /shipments/shipping.id resource with the id obteined in the order. For more information, learn our Shipments guide.
For ME1, Custom or delivery orders to be agreed, we make the contact telephone number available in the buyer's data whenever this information is in the account. Example:

"phone": - {
"area_code": "11",
"number": "12345678",
"extension": null,
},

Fraud alerts (stop shipping)

After the payment approval, and due to the relationship with banks and cards, we may receive an alert that the order is a fraud and to avoid a financial expense, you shouldn´t send the merchandise to the buyer.
In this case, or order is marked with the tag "fraud_risk_detected" and we send a notification with the topic "orders_v2" with the ID of this order.
Once identified, the order must be canceled. Case the seller has already been sent products, it will be necessary to check or send it through the Mercado Libre or Mercado Pago sites.


Total_amount_with_shipping calculation

With the response that you get in the GET /orders/:id request and the request to GET /shipments/:shipping_id resource, both with the header x-format-new: true, you have to do the next calculation:

total_amount_with_shipping = total_amount + taxes.amount + lead_time.cost

*With the same item currency.

The total_amount and taxes.amount are obtained by the /orders resource, and the lead_time.cost resource is obtained from the /shipments.

Important:
In case taxes.currency_id is different from items.currency_id we must obtain the conversion ratio.

Request:

curl -X GET  https://api.mercadolibre.com/currency_conversions/search?from=$CURRENCY_ID&to=$CURRENCY_ID

Example:

curl -X GET  https://api.mercadolibre.com/currency_conversions/search?from=ARS&to=BRL

Response:

{
  "ratio": 0.0704988
}


What will happen to a sale based on its delivery?

Without Mercado Envíos: The seller will be notified by e-mail or phone.

  • If the item has already been delivered and there is evidence of that, the seller is covered in the event of a chargeback. This means that the sales money will not be deducted.
  • If the item has not been delivered yet, the seller should refund the money.
  • Learn how to make a refund via API in Refunds and cancellations.
  • For more information, we suggest reading the documentation of “Seller Protection Program Requirements”.

With Mercado Envíos: If the label has not been printed yet, the sale will be cancelled and a notification will be sent to the seller. Otherwise, if the item has already been shipped, Mercado Libre will notify the shipping company to return the item.


Search orders

Important:
As of April 6, we will remove the following data from the response to /orders/search:
From seller:
- first_name
- last_name
- email
- phone seller.alternative_phone

From buyer:
- first_name
- last_name
- email
- phone
- alternative_phone
- billing_info
You can get this information making request to /orders.

The search orders resource will help you browse every order that belongs to users for whom you have a valid token. You will be able to see those orders canceled manually, that is, with status manually_cancelled and those that have an item removed, using the search as buyer. If you search as a seller, you will continue to filter such (canceled) orders.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?buyer=$BUYER_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?buyer=89660613&q=2032217210

Response:

{
    "query": "2032217210",
    "results": [
        {
            "seller": {
                "phone": {
                    "number": "11971427863",
                    "extension": "",
                    "area_code": null,
                    "verified": false
                },
                "alternative_phone": {
                    "number": "",
                    "extension": "",
                    "area_code": ""
                },
                "nickname": "VENDASDKMB",
                "last_name": "Cheracomo",
                "id": 239432672,
                "first_name": "Demétrio",
                "email": "dcherac.8m6k0q+2-ogiydgmrsge3tenby@mail.mercadolivre.com"
            },
            "payments": [
                {
                    "reason": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g",
                    "status_code": null,
                    "total_paid_amount": 129.95,
                    "operation_type": "regular_payment",
                    "transaction_amount": 129.95,
                    "date_approved": "2019-05-22T03:51:07.000-04:00",
                    "collector": {
                        "id": 239432672
                    },
                    "coupon_id": null,
                    "installments": 1,
                    "authorization_code": "008877",
                    "taxes_amount": 0,
                    "id": 4792155710,
                    "date_last_modified": "2019-05-22T03:51:07.000-04:00",
                    "coupon_amount": 0,
                    "available_actions": [
                        "refund"
                    ],
                    "shipping_cost": 0,
                    "installment_amount": 129.95,
                    "date_created": "2019-05-22T03:51:05.000-04:00",
                    "activation_uri": null,
                    "overpaid_amount": 0,
                    "card_id": 203453778,
                    "status_detail": "accredited",
                    "issuer_id": "24",
                    "payment_method_id": "master",
                    "payment_type": "credit_card",
                    "deferred_period": null,
                    "atm_transfer_reference": {
                        "transaction_id": "135292",
                        "company_id": null
                    },
                    "site_id": "MLB",
                    "payer_id": 89660613,
                    "marketplace_fee": 14.290000000000001,
                    "order_id": 2032217210,
                    "currency_id": "BRL",
                    "status": "approved",
                    "transaction_order_id": null
                }
            ],
            "fulfilled": true,
            "buying_mode": "buy_equals_pay",
            "taxes": {
                "amount": null,
                "currency_id": null
            },
            "order_request": {
                "change": null,
                "return": null
            },
            "expiration_date": "2019-06-19T03:51:07.000-04:00",
            "feedback": {
                "sale": null,
                "purchase": null
            },
            "shipping": {
                "id": 27968238880
            },
            "date_closed": "2019-05-22T03:51:07.000-04:00",
            "id": 2032217210,
            "manufacturing_ending_date": null,
            "hidden_for_seller": false,
            "order_items": [
                {
                    "item": {
                        "seller_custom_field": null,
                        "condition": "new",
                        "category_id": "MLB33383",
                        "variation_id": null,
                        "variation_attributes": [],
                        "seller_sku": null,
                        "warranty": "Garantia de 1 ano fabricante",
                        "id": "MLB1054990648",
                        "title": "Kit Com 03 Adesivo Spray 3m 75 Cola Silk Sublimação 300g"
                    },
                    "quantity": 1,
                    "differential_pricing_id": null,
                    "sale_fee": 14.29,
                    "listing_type_id": "gold_special",
                    "base_currency_id": null,
                    "unit_price": 129.95,
                    "full_unit_price": 129.95,
                    "base_exchange_rate": null,
                    "currency_id": "BRL",
                    "manufacturing_days": null
                }
            ],
            "date_last_updated": "2020-02-14T02:55:49.811Z",
            "last_updated": "2019-05-28T15:16:04.000-04:00",
            "comments": null,
            "pack_id": null,
            "coupon": {
                "amount": 0,
                "id": null
            },
            "shipping_cost": 0,
            "date_created": "2019-05-22T03:51:05.000-04:00",
            "application_id": "7092",
            "pickup_id": null,
            "status_detail": null,
            "tags": [
                "delivered",
                "paid"
            ],
            "buyer": {
                "phone": {
                    "number": "99962663",
                    "extension": "",
                    "area_code": "41",
                    "verified": false
                },
                "alternative_phone": {
                    "number": "30576339",
                    "extension": "",
                    "area_code": "41"
                },
                "nickname": "S.VICTORHUGO",
                "last_name": "Schemberger",
                "id": 89660613,
                "first_name": "Victor Hugo",
                "email": "vschemb.y14cdz+2-ogiydgmrsge3tenbz@mail.mercadolivre.com"
            },
            "total_amount": 129.95,
            "paid_amount": 129.95,
            "mediations": [],
            "currency_id": "BRL",
            "status": "paid"
        }
    ],
    "sort": {
        "id": "date_asc",
        "name": "Date ascending"
    },
    "available_sorts": [
        {
            "id": "date_desc",
            "name": "Date descending"
        }
    ],
    "filters": [],
    "paging": {
        "total": 1,
        "offset": 0,
        "limit": 50
    },
    "display": "complete"
}


Products information in orders

This request shows all the information of the products that are in the same order:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$order_id/product

Response:

{
	"attributes": [
    		{
        		"name": "IMEI",
        	"value": "111",
        		"id": 1
    	},
    		{
        		"name": "IMEI",
        	"value": "222",
        		"id": 2
    	},
    		{
        		"name": "entry_date",
        	"value": "01/01/2001",
        		"id": 3
    	}
	]
}


Filter

Important:
The mediations array only includes the mediation's id field in Orders and Orders/search.

To filter your orders with status "paid" accounts with the following filters:

item: tittle ID
tags: it can be some status separated by ','
tags.not: it can be some status separated by ','
q: it is a field that allows you to search by:

  • order id
  • item id
  • item title
  • nickname of the counterpart

order.status: it can be some status separated by ','
order.date_last_updated.from
order.date_last_updated.to
order.date_created.from
order.date_created.to
order.date_closed.from
order.date_closed.to
mediations.stage: it can be some status separated by ','
mediations.status: it can be some status separated by ','
feedback.status: it can be some status separated by ','
feedback.sale.rating: it can be some status separated by ','
feedback.sale.fulfilled
feedback.purchase.rating: it can be some status separated by ','
feedback.purchase.fulfilled

Nota:
The “q” filter does not consider the first_name, last_name and email values ​​when searching for an orden.

Example:

curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=seller_id&order.status=paid

If you want to filter your orders by date, you should do the following:

curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&order.date_created.from=2015-07-01T00:00:00.000-00:00&order.date_created.to=2015-07-31T00:00:00.000-00:00
Note:
To filter by date you only need the hour. Information about minutes, seconds and milliseconds is removed.


Sort

In this case, you should add “sort” to the available sort ID that you wish to apply, for example: “date_desc”.

curl  -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller={seller_id}&order.status=paid&sort=date_desc
Note:
By default, it sorts by date_asc. The sorting date is:
- Sellers por date_closed.
- Buyers por date_created.


Recent orders

Recent orders are the latest orders that were generated for a user. The response will include orders in which the current date is before expiration_date, and haven’t been qualified by any of the parties. Searching for a seller’s recent orders:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/recent?seller=seller_id

Searching for a buyer’s recent orders:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/recent?buyer=buyer_id


Mercado Shops Orders

Mercado Shops orders are also available in Mercado Libre API.

To identify these orders, you should use the tag "mshops".

Example of Mercado Shops orders:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' https://api.mercadolibre.com/orders/$ORDER_ID

{
    "id": 2063200914,
    "date_created": "2019-06-24T15:53:04.000-04:00",
    "date_closed": "2019-06-24T15:53:06.000-04:00",
    "last_updated": "2019-06-24T15:53:06.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {
        "sale": null,
        "purchase": null
    },
    "mediations": [],
    "comments": null,
    "pack_id": null,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "total_amount": 25,
    "paid_amount": 31.9,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2019-07-22T15:53:06.000-04:00",
    "order_items": [
        
            "item": {
                "id": "MLB1231068128",
                "title": "Teste Anúncio Me2 - Não Ofertar",
                "category_id": "MLB271107",
                "variation_id": null,
                "seller_custom_field": null,
                "variation_attributes": [],
                "warranty": null,
                "condition": "new",
                "seller_sku": null
            },
            "quantity": 1,
            "unit_price": 25,
            "full_unit_price": 25,
            "currency_id": "BRL",
            "manufacturing_days": null
        
    ],
    "currency_id": "BRL",
    "payments": [
        
            "id": 4898000077,
            "order_id": 2063200914,
            "payer_id": 419067349,
            "collector": {
                "id": 419059118
            },
            "card_id": 313381752,
            "site_id": "MLB",
            "reason": "Teste Anúncio Me2 - Não Ofertar",
            "payment_method_id": "master",
            "currency_id": "BRL",
            "installments": 1,
            "issuer_id": "24",
            "atm_transfer_reference": {
                "company_id": null,
                "transaction_id": "1234567"
            },
            "coupon_id": null,
            "activation_uri": null,
            "operation_type": "regular_payment",
            "payment_type": "credit_card",
            "available_actions": [
                "refund"
            ],
            "status": "approved",
            "status_code": null,
            "status_detail": "accredited",
            "transaction_amount": 25,
            "taxes_amount": 0,
            "shipping_cost": 6.9,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 31.9,
            "installment_amount": 31.9,
            "deferred_period": null,
            "date_approved": "2019-06-24T15:53:05.000-04:00",
            "authorization_code": "1234567",
            "transaction_order_id": null,
            "date_created": "2019-06-24T15:53:05.000-04:00",
            "date_last_modified": "2019-06-24T15:53:05.000-04:00"
        
    ],
    "shipping": {
        "id": 28001747957
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "mshops",
        "test_order",
        "not_delivered",
        "paid"
    ],
    "buyer": {
        "id": 419067349,
        "nickname": "TT763866",
        "email": "ttest.6hqmq6+2-ogiydmmzsgaydsnjx@mail.mercadolivre.com",
        "first_name": "Test",
        "last_name": "Test",
    "seller": {
        "id": 419059118,
        "nickname": "TETE8288849",
        "email": "ttest.hpz2z6q+2-ogiydmmzsgaydsnjs@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test"
    },
    "taxes": {
        "amount": null,
        "currency_id": null
    
}

The JSON structure is the same that Mercado Libre orders. Market Shops orders can also be made by cart. For this, refer to the Shopping cart orders documentation.


Get Mercado Shops orders

To consult the Marcado Shops orders, just consult by the tag mshops as in the following example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search?seller=seller_id&tags=mshops


Archived orders

If you are looking for an order with expiration_date after current date or which was qualified by both parties, you can use the search archived orders resource: Searching for a seller’s archived orders:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/archived?seller=seller_id

Searching for a buyer’s archived orders:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/archived?buyer=buyer_id


Pending orders

This search will retrieve all the orders with “pending” status, and will automatically skip canceled orders. If you want to see a specific seller's orders, send the seller_id:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/pending?seller=seller_id

To search by buyer, replace the parameters as follows:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/search/pending?buyer=user_id


Order status

Order statuses are the following:
confirmed Initial status of an order, even if it is still unpaid.
payment_required Order payment should be confirmed to display user information.
payment_in_process There is an order-related payment, but it has not been credited yet.
partially_paid The order have a credited associated payment, but it is not enough.
paid The order-related payment is credited, but it is not enough.
cancelled For some reason, the order was not fulfilled.*
invalid The order was invalidated as it came from a malicious buyer.

Notes:
An order may be canceled due to the following reasons:
- Payment approval was required to subtract stock, but, during the approval process period, the item was paused/terminated due to stockout; so, the payment is returned to the buyer.
- Payment was required, but, as it was not paid within a specific period, it was automatically canceled.
- After making a transaction, for some reason the seller is banned from the site.
- If for some reason the seller rates the transaction as non-completed, the order takes the "status = confirmed." If there is an approved payment, it will be automatically returned. Bear in mind that an order that has not been completed by the seller at front will appear as "Cancelled" and with api "status: confirmed".


Error code reference

Error Error message Description Possible solution
order_not_found Order not found. $order_id incorrect. The order cannot be found, check if the order_id is correct. More information.
empty_order_id Order ID can not be empty. $order_id is null. The parameter order_id cannot be null, check the URL used. More information
invalid_order_id Invalid order ID. $order_id incorrect. The parameter order_id must be a integer number. For search your orders see this topic.
not_identified_user Can not identify the user. Do not exist a Token. Send a token.
not_owned_order The user has not access to the order. $seller or $buyer incorrect. To see one order, your access_token must be generated from seller or buyer.
caller.id.invalid caller.id does not match buyer nor seller. $seller or $buyer incorrect. To see one order, you must be use one ID from seller or buyer.
feedback_not_found The feedback does not exist. Reply error. Check if feedback exist for give a reply.
invalid_fulfilled ‘fulfilled’ parameter must be true or false. Error on give feedback. Check the parameter $fulfilled this must be boolean (remove quotation marks) and check if the parameter $reason is not null in case of $fulfilled: false.
reply_time_expired Reply time expired. There is a 14 days period to reply a feedback. Error on give reply on feedback. The reply can be sent in 14 days past the feedback date.
reply_already_exists Reply already exists for the feedback. Error on give reply on feedback. The feedback supports only one reply.

HTTP response code references

Orders may return the code http 206 when it has not been possible to obtain any data. Keep in mind that in most cases the information you receive will be enough for you to continue working.
In the response header X-Content-Missing you will have the name of the fields without information, which can be "buyer", "feedback", "mediations", "seller" and / or "shipping".


Request::

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID

Response:


< HTTP/1.1 206 Partial Content> X-Content-Missing: buyer, feedback

{
  "id": 768570754,
  "status": "paid",
  "status_detail": null,
  "date_created": "2013-05-27T10:01:50.000-04:00",
  "date_closed": "2013-05-27T10:04:07.000-04:00",
  "order_items": - [
	- {
  	"item": - {
    	"id": "MLB12345678",
  	  "title": "Samsung Galaxy",
    	"variation_id": null,
    	"variation_attributes": [
    	],
  	},
  	"quantity": 1,
  	"unit_price": 499,
  	"currency_id": "BRL",
	},
  ],
  "total_amount": 499,
  "currency_id": "BRL",
  "buyer": - { },
  },
  "seller": - {
	"id": "123456789",
	"nickname": "VENDEDORTESTES",
	"email": "a@a.com",
	"phone": - {
  	"area_code": null,
  	"number": "11 12345678",
  	"extension": "11",
	},
	"first_name": "Vendedor de Testes",
	"last_name": "testes de documentacao",
  },
  "payments": - [
	- {
  	"id": "596707837",
  	"transaction_amount": 499,
  	"currency_id": "BRL",
  	"status": "approved",
  	"date_created": null,
  	"date_last_modified": null,
	},
  ],
  "feedback": - { },
  "shipping": - {
	"id": 20676482441
	
  },
  "tags": - [
	"paid",
	"not_delivered",
  ],
}


Next:
Messaging after sale.

or register to recieve the latest news about our API