Last update 02/09/2022

Orders notes

A note is an annotation sellers can add to orders. Notes can have up to 300 characters each and, once you post a note, you can either modify or delete it.

Add a note to an order

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{  	
   	"note": "test",
}' https://api.mercadolibre.com/orders/$ORDER_ID/notes

See order notes

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

Modify a note

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{
   	"note": "test2",
}' https://api.mercadolibre.com/orders/$ORDER_ID/notes/$NOTE

Delete notes

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

Block bids

Even though we have a fraud prevention feature and flows to keep buyers and sellers safe, sometimes you may find users who, for some reason, bid on your items. These cases can be sent to your blacklist to prevent them from bidding.


Block bids from a specific user

Make a POST request with the cust_id of the user you want to block in JSON and yours in the url. Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{ user_id: {cust_id} }
https://api.mercadolibre.com/users/$CUST_ID/order_blacklist
banner footer

Subscribe to our Newletter

or register to recieve the latest news about our API