Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade


Last update 28/12/2022

Pre-negotiated discount per item (PRE_NEGOTIATED)

Sellers are regularly invited to participate in different website campaigns. In this type of campaign the seller previously negotiates with Mercado Libre commercial representative a discount for certain items, setting price, offered discount and granted benefit. If you received an invitation and want to join, use the resources below.

Seller view

Check pre-negotiated campaign details


curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'


    "id": "P-MLM671010",
    "type": "PRE_NEGOTIATED",
    "status": "started",
    "start_date": "2021-07-23T19:00:00Z",
    "finish_date": "2021-12-05T04:00:00Z",
    "deadline_date": "2021-12-05T04:00:00Z",
    "name": "CBT Pre negotiated test",
    "offers": [
            "id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
            "original_price": 2196.7,
            "new_price": 1600,
            "status": "candidate",
            "start_date": "2021-07-30T17:00:00Z",
            "end_date": "2021-08-13T04:00:00Z",
            "benefits": {
                "type": "REBATE",
                "meli_percent": 9.1,
                "seller_percent": 18.1

Specific campaign fields

Offers: detail of pre-negotiated discount

  • id: offer identification.
  • original_price: original item price.
  • new_price: final item price.
  • status: promotion item status.
  • start_date: start date of offer in promotion.
  • end_date: end date of offer in promotion.

  • Benefits: promotion benefit details
        • type: benefit type.
        • meli_percent: percentage contributed by Mercado Libre.
        • seller_percent: percentage contributed by seller.


    pending: promotion approved but not yet started.
    started: active promotion.
    finished: finished promotion.

    Check items in a pre-negotiated campaign


    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'


        "results": [
                "id": "MLM902888699",
                "status": "candidate",
                "price": 110.03,
                "original_price": 0,
                "currency_id": "USD",
                "offer_id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
                "meli_percentage": 9.1,
                "seller_percentage": 18.1,
                "start_date": "2021-07-30T17:00:00Z",
                "end_date": "2021-08-13T04:00:00Z"
        "paging": {
            "offset": 0,
            "limit": 0,
            "total": 1

    When a new campaign is created, all applicable items are selected. The initial item (status) is "candidate" with a unique "offer_id". When the seller adds an item to the campaign, item status changes and goes to programmed or active.

    Item status

    candidate: candidate item to participate in the promotion.
    programmed: approved and programmed promotion item.
    active: campaign active item.

    Accept a pre-negotiated discount per item

    Once a discount has been negotiated for an item, the seller can accept the pre-negotiation with the following resource.


    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d 


    curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d 


       "offer_id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
       "price": 80.14,
       "original_price": 110.02,
       "currency_id": "USD"


    deal_id: promotion identification.
    offer_id: negotiated offer identification.
    promotion_type: type of promotion (PRE_NEGOTIATED).

    Delete pre-negotiated discount

    Use this resource to Pre-negotiated Discount per Item


    curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN'$ITEM_ID?user_id=$USER_ID&promotion_type=PRE_NEGOTIATED&deal_id=$DEAL_ID


    curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN'
    Remember that if an item pre-negotiated discount is removed, the item will no longer be a candidate.

    Next post: Co-funded campaigns