MercadoLibre API

https://global-selling.mercadolibre.com/devsite/
Admin
MercadoLibre API provides documentation and tools for developers to integrate their applications...
Tokens:506,185
Snippets:2,974
Trust Score:9.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### Promotion Details - Example

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example GET request to retrieve promotion details for a specific promotion ID and type.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET \
'https://api.mercadolibre.com/marketplace/seller-promotions/promotions/C-MLM201059?promotion_type=SELLER_CAMPAIGN&user_id=1317418851' \
--header 'version: v2'
```

--------------------------------

### Response example for started items

Source: https://global-selling.mercadolibre.com/devsite/seller-campaign

JSON response structure for items that have already started in the campaign.

```json
{
    "results": [
        {
            "id": "MLM4007773188",
            "status": "started",
            "price": 19,
            "original_price": 20,
            "currency_id": "USD",
            "start_date": "2025-12-09T00:00:00",
            "end_date": "2025-12-22T23:59:59",
            "net_proceeds": {
                "amount": 10.61,
                "currency": "USD"
            }
        }
    ],
    "paging": {
        "offset": 0,
        "limit": 50,
        "total": 1,
        "searchAfter": ""
    }
}
```

--------------------------------

### Get Available Marketplace Sites

Source: https://global-selling.mercadolibre.com/devsite/global-listing

Examples of API requests and response for getting available marketplace sites.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplaces/users/$USER_ID
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplaces/users/2560656533
```

```json
{
    "user_id": 2560656533,
    "site_id": "CBT",
    "marketplaces": [
        {
            "user_id": 2560656535,
            "site_id": "MLM",
            "logistic_type": "remote"
        },
        {
            "user_id": 2565546850,
            "site_id": "MLB",
            "logistic_type": "remote"
        },
        {
            "user_id": 2565546852,
            "site_id": "MLC",
            "logistic_type": "remote"
        },
        {
            "user_id": 2565546852,
            "site_id": "MLC",
            "logistic_type": "remote"
        }
    ]
}
```

--------------------------------

### Example GET request for missed notifications

Source: https://global-selling.mercadolibre.com/devsite/receive-notifications

A concrete example of the GET request using a specific application ID.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/missed_feeds?app_id=3486171129139063
```

--------------------------------

### Filter by status started

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example request filtering by status 'started'. Uses a specific promotion ID and user ID.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/marketplace/seller-promotions/promotions/P-MLM13773008/items?user_id=1317418851&status=started' \
--header 'version: v2'
```

--------------------------------

### Check offers - Example

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example GET request to check an offer with a specific offer ID and user ID. Uses the internal API endpoint.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://internal-api.mercadolibre.com/marketplace/seller-promotions/promotions/offer/OFFER-MLM1873971357-10078845289/1280008696' \
--header 'version: v2'
```

--------------------------------

### GET promotion items example

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example request with concrete values: promotion ID C-MLM201059, status candidate, promotion type SELLER_CAMPAIGN, and user ID 1317418851.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/marketplace/seller-promotions/promotions/C-MLM201059/items?status=candidate&promotion_type=SELLER_CAMPAIGN&user_id=1317418851' \
--header 'version: v2'
```

--------------------------------

### Shipment detail example

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Example request to get shipment details for a specific shipment ID.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' -X GET https://api.mercadolibre.com/marketplace/shipments/40531399184
```

--------------------------------

### Example Next Page Request

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example request with actual search_after value.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
user_id=1317418851&limit=2&search_after=a179f4702c65ce28484f26cf4fbcb0cbecb05b2ba75aaaebba697cb2511fa7e285ee29cdb1746ea07ae29c53297c' \
--header 'version: v2'
```

--------------------------------

### Available Listing Types Example

Source: https://global-selling.mercadolibre.com/devsite/listing-types-and-exposures

Example request with concrete user ID and category ID.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1234/available_listing_types?category_id=MLA1055
```

--------------------------------

### Example Pagination Request

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example request with actual user_id and limit values.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
user_id=1317418851&limit=2' \
--header 'version: v2'
```

--------------------------------

### GET available rules for an item (example with item ID)

Source: https://global-selling.mercadolibre.com/devsite/manage-automations

Example request using a specific item ID (MLM2245313004) to retrieve available automation rules. Demonstrates the endpoint with a real item identifier.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/MLM2245313004/prices/automate/rules
```

--------------------------------

### Get shipment items - Example

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example curl command with a specific shipment ID (12234123) to demonstrate the request.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/12234123/items
```

--------------------------------

### Response for GET available rules

Source: https://global-selling.mercadolibre.com/devsite/manage-automations

Example JSON response from the GET request, showing the item_id and the list of available rules (INT and INT_EXT) with their titles and descriptions.

```json
{
    "item_id": "MLM2245313004",
    "rules": [
        {
            "rule_id": "INT",
            "title": "Price to win on Mercado Libre",
            "description": "Your price will be adjusted by comparing the price and selling conditions of same listings on Mercado Libre and other marketplaces."
        },
        {
            "rule_id": "INT_EXT",
            "title": "Best price on Mercado Libre and off the site",
            "description": "Your price will be adjusted by comparing the price and selling conditions of same listings on Mercado Libre and other marketplaces."
        }
    ]
}
```

--------------------------------

### Check Item Promotions with curl and JSON response

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Use the GET request to retrieve all promotions for an item and their current status. The example uses a real item ID and user ID, and includes the 'version: v2' header. The response is a JSON array with promotion objects, each containing fields like id, type, status, dates, name, and optional offers/benefits.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID'
```

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM2184616078?user_id=1317418851' \
--header 'version: v2'
```

```json
[
  {
      "id": "P-MLM13795204",
      "type": "DEAL",
      "status": "started",
      "start_date": "2024-01-26T12:00:00-06:00",
      "finish_date": "2024-02-16T00:00:00-06:00",
      "deadline_date": "2024-02-16T06:00:00Z",
      "name": "bosch campaña"
  },
  {
      "id": "",
      "type": "DOD",
      "status": "candidate",
      "start_date": "2024-02-16T21:00:00",
      "finish_date": "2024-02-17T20:59:59"
  },
  {
      "id": "P-MLM13773008",
      "type": "PRE_NEGOTIATED",
      "status": "started",
      "start_date": "",
      "finish_date": "",
      "name": "Commercial Shared Discounts",
      "offers": [
          {
              "id": "CANDIDATE-MLM2184616078-70509424939",
              "original_price": 130,
              "new_price": 100,
              "status": "candidate",
              "start_date": "2024-02-02T06:00:00Z",
              "end_date": "2024-02-29T05:59:59Z",
              "benefits": {
                  "type": "REBATE",
                  "meli_percent": 15.4,
                  "seller_percent": 7.7
              }
          }
      ]
  },
  {
      "id": "P-MLM13819020",
      "type": "MARKETPLACE_CAMPAIGN",
      "status": "started",
      "start_date": "2024-02-02T20:00:00Z",
      "finish_date": "2024-03-01T20:00:00Z",
      "deadline_date": "2024-03-01T20:00:00Z",
      "name": "Ofertas sugeridas",
      "benefits": {
          "type": "REBATE",
          "meli_percent": 0,
          "seller_percent": 0
      }
  },
  {
      "id": "P-MLM13821030",
      "type": "SMART",
      "status": "started",
      "start_date": "",
      "finish_date": "",
      "name": "Gánale a la competencia con un aporte de Mercado Libre",
      "offers": [
          {
              "id": "CANDIDATE-MLM2184616078-70509425185",
              "original_price": 130,
              "new_price": 100,
              "status": "candidate",
              "start_date": "2024-02-02T20:00:00Z",
              "end_date": "2024-03-01T20:00:00Z",
              "benefits": {
                  "type": "REBATE",
                  "meli_percent": 0,
                  "seller_percent": 23.1
              }
          }
      ]
  },
  {
      "id": "",
      "type": "PRICE_DISCOUNT",
      "status": "candidate",
      "start_date": "",
      "finish_date": ""
  },
  {
      "id": "P-MLM13757022",
      "type": "DEAL",
      "status": "started",
      "start_date": "2024-01-29T00:00:00-06:00",
      "finish_date": "2024-02-12T00:00:00-06:00",
      "deadline_date": "2024-02-11T06:00:00Z",
      "name": "Ano nuevo chino"
  }
]
```

--------------------------------

### GET promotion items response

Source: https://global-selling.mercadolibre.com/devsite/manage-promotions-gs

Example JSON response showing two candidate items with their prices, dates, and net proceeds. The paging object indicates offset, limit, total, and searchAfter.

```json
{
    "results": [
        {
            "id": "MLM2199514002",
            "status": "candidate",
            "price": 70,
            "original_price": 0,
            "currency_id": "USD",
            "start_date": "2024-01-10T00:00:00",
            "end_date": "2024-01-20T23:59:59",
            "net_proceeds": {
                "amount": 20.68,
                "currency": "USD"
            }
        },
        {
            "id": "MLM2184798066",
            "status": "candidate",
            "price": 30,
            "original_price": 0,
            "currency_id": "USD",
            "start_date": "2024-01-10T00:00:00",
            "end_date": "2024-01-20T23:59:59",
            "net_proceeds": {
                "amount": 20.68,
                "currency": "USD"
            }
        }
    ],
    "paging": {
        "offset": 0,
        "limit": 50,
        "total": 2,
        "searchAfter": ""
    }
}
```

--------------------------------

### Get Working Days - 200 OK response

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example response for the Get Working Days request. Shows holiday dates with fields like 'checked', 'closed', 'finalized', 'enabled', 'mandatory', 'description', and 'date'. Note that when 'mandatory' is true, the date cannot be modified.

```json
{
  "dates": [
    {
      "closed": false,
      "finalized": true,
      "enabled": true,
      "checked": true,
      "description": "Rosh Hashanah",
      "date": "2025-09-23"
    },
    {
      "closed": false,
      "finalized": true,
      "enabled": true,
      "checked": false,
      "description": "Yom Kippur",
      "date": "2025-10-01"
    },
    {
      "closed": false,
      "finalized": false,
      "enabled": false,
      "checked": true,
      "mandatory": true,
      "description": "National Holiday",
      "date": "2025-10-15"
    }
  ]
}
```

--------------------------------

### Get shipping cost for a specific item

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example curl command to get the shipping cost for a specific item. Replace $ACCESS_TOKEN and the item ID (e.g., MLM1234567890) with valid values.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/MLM1234567890/shipping_options/cost
```

--------------------------------

### Get shipment items with curl and example response

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

The first two commands are curl requests to the /marketplace/shipments/$SHIPMENT_ID/items endpoint. The first uses a placeholder shipment ID, the second uses a concrete example ID. The JSON response shows the structure of the items list, including item_id, variation_id, description, quantity, manufacturing_time, dimensions, and sender_id.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/items
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/12234123/items
```

```json
[
    {
        "item_id": "MLB14385311",
        "variation_id": null,
        "description": "Test item",
        "quantity": 1,
        "manufacturing_time": null,
        "dimensions": {
            "height": 10,
            "width": 10,
            "length": 10,
            "weight": 318
        },
        "sender_id": 123123123
    }
]
```

--------------------------------

### Get shipment items - Response

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example JSON response showing the items associated with a shipment, including item ID, variation ID, description, quantity, manufacturing time, dimensions, and sender ID.

```json
[
    {
        "item_id": "MLB14385311",
        "variation_id": null,
        "description": "Test item",
        "quantity": 1,
        "manufacturing_time": null,
        "dimensions": {
            "height": 10,
            "width": 10,
            "length": 10,
            "weight": 318
        },
        "sender_id": 123123123
    }
]
```

--------------------------------

### Get carrier information with curl

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Get carrier information for a shipment, including the carrier name and tracking URL. The first command uses a placeholder shipment ID; the second shows a concrete example. The response is a JSON object with url and name fields.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/carrier
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/12234123/carrier
```

```json
{
  "url": "tracking URL",
  "name": "Carrier Name"
}
```

--------------------------------

### Report Tracking Example

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example request with a specific shipment ID to report tracking information.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST https://api.mercadolibre.com/marketplace/shipments/28262122315/tracking 
  -d '{
    "tracking_id": "String",
    "tracking_url": "http://carrier.com",
    "carrier": "name carrier"
}'
```

--------------------------------

### Get pack details with GET /marketplace/orders/pack/$PACK_ID

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Use the pack_id from the order details to get pack information. A filled family_pack_id indicates this is a split (child) pack.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/orders/pack/$PACK_ID
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/orders/pack/2000008691345363
```

```json
{
  "id": 2000008691345363,
  "status": "to_be_shipped",
  "status_detail": null,
  "family_pack_id": 2000008674781009,
  "orders": [...],
  ...
}
```

--------------------------------

### Shipping cost response example

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Example JSON response from the shipping cost endpoint, showing shipping_fee, currency_id, site_id, billable_weight, and free_shipping fields.

```json
{
    "shipping_fee": 19.96,
    "currency_id": "USD",
    "site_id": "MLM",
    "billable_weight": {
        "value": 1000,
        "unit": "g"
    },
    "free_shipping": false
}
```

--------------------------------

### Shipment costs response example

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Example JSON response showing gross_amount, receiver, senders, discounts, and compensations. The response includes fields like cost, save, and compensation.

```json
{
  "gross_amount": 508.14,
  "currency_id": "USD",
  "receiver": {
      "user_id": 12345,
      "cost": 0,
      "compensation": 0,
      "save": 0,
      "discounts": [
          {
              "rate": 1,
              "type": "ratio",
              "promoted_amount": 254.07
          }
      ],
      "cost_details": [],
      "compensations": []
  },
  "senders": [
      {
          "user_id": 456789,
          "cost": 177.85,
          "compensations":[
            {
              "amount":173.27,
              "reason":"incorrect_dimensions",
              "comment":"Incorrect package dimensions"
            }
          ],
          "save": 76.22,
          "discounts": [
              {
                  "rate": 0.3,
                  "type": "mandatory",
                  "promoted_amount": 76.22
              }
          ],
      "compensation": 0
      }
  ]
}
```

--------------------------------

### Shipment detail request

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Generic request to get shipment details using the GET method with the mandatory x-format-new header.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID
```

--------------------------------

### Inform Delivered - Example DELIVERED

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Reports that the shipment has been delivered to the buyer. The status 'delivered' is final and irreversible. The response confirms success.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST https://api.mercadolibre.com/marketplace/shipments/28262122315/tracking/status
  -d '{
    "tracking_id": "TKR123",
    "status": "delivered"
}'
```

```json
{
    "status": "success"
}
```

--------------------------------

### Get shipment status history with curl

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Retrieve the status and substatus history for a shipment. The first command uses a placeholder shipment ID; the second shows a concrete example. The response is a JSON array with status, substatus, and date fields.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/history
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/12234123/history
```

```json
[
  {
    "status": "ready_to_ship",
    "substatus": "printed",
    "date": "2016-12-30T12:32:35.000Z"
  },
  {
    "status": "handling",
    "substatus": "waiting_for_label_generation",
    "date": "2016-12-30T12:32:35.000Z"
  }
]
```

--------------------------------

### Get order details with GET /marketplace/orders/$ORDER_ID

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Use the order_id from the split notification to retrieve order details. The response includes the pack_id, which is required for the next step.

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

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/orders/2000012494387040
```

```json
{
  "id": 2000012494387040,
  "pack_id": 2000008691345363,
  "order_items": [...],
  "shipping": { "id": 45263494304 },
  ...
}
```

--------------------------------

### Verify split by shipment_id in pack response

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Verification example: if the shipment.id matches the original shipment_id and status_detail is "splitted", the split was successfully executed.

```json
{
  "id": 2000008674781009,
  "status": "cancelled",
  "status_detail": "splitted",
  "shipment": { "id": 45255234865 }
  ...
}
```

--------------------------------

### Get items response example

Source: https://global-selling.mercadolibre.com/devsite/global-listing

Example response from the Get items endpoint for a cross-border trade (CBT) item. Shows fields such as id, attributes, shipping, sale_terms, net_proceeds, and cbt_item_id.

```json
{
    "id": "MLB6020770144",
    "site_id": "MLB",
    "date_created": "2025-12-08T19:35:10.715Z",
    "title": "Bola De Futebol Reflexiva Que Brilha",
    "descriptions": [],
    "attributes": [
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "276243",
            "value_name": "Genérica",
            "value_struct": null,
            "values": [
                {
                    "id": "276243",
                    "name": "Genérica",
                    "struct": null
                }
            ]
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230284",
            "value_name": "Novo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Novo",
                    "struct": null
                }
            ]
        },
        {
            "id": "SELLER_SKU",
            "name": "SKU",
            "value_id": "",
            "value_name": "SC-1520",
            "value_struct": null,
            "values": [
                {
                    "id": "",
                    "name": "SC-1520",
                    "struct": null
                }
            ]
        }
    ],
    "listing_type_id": "gold_pro",
    "permalink": "https://produto.mercadolivre.com.br/MLB-6020770144-bola-de-futebol-reflexiva-que-brilha-_JM",
    "shipping": {
        "mode": "me2",
        "free_shipping": true,
        "logistic_type": "drop_off",
        "dimensions": "",
        "tags": [
            "mandatory_free_shipping"
        ]
    },
    "status": "active",
    "sub_status": [],
    "tags": [
        "standard_price_by_channel",
        "test_item",
        "kvs_primary",
        "cbt_item",
        "cbt_ids",
        "net_proceeds_prices",
        "immediate_payment",
        "cart_eligible"
    ],
    "warranty": "Garantia de fábrica: 90 dias",
    "catalog_product_id": null,
    "domain_id": "MLB-FOOTBALL_BALLS",
    "international_delivery_mode": "DDP",
    "inventory_id": "",
    "category_id": "MLB6852",
    "official_store_id": null,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantia",
            "value_id": "2230279",
            "value_name": "Garantia de fábrica",
            "value_struct": {
                "number": 0,
                "unit": ""
            },
            "values": [
                {
                    "id": "2230279",
                    "name": "Garantia de fábrica",
                    "struct": {
                        "number": 0,
                        "unit": ""
                    }
                }
            ]
        },
        {
            "id": "GLOBAL_PRICE",
            "name": "Preço global",
            "value_id": null,
            "value_name": "65.99 USD",
            "value_struct": {
                "number": 65.99,
                "unit": "USD"
            },
            "values": [
                {
                    "id": null,
                    "name": "65.99 USD",
                    "struct": {
                        "number": 65.99,
                        "unit": "USD"
                    }
                }
            ]
        }
    ],
    "sold_quantity": 0,
    "available_quantity": 40,
    "last_updated": "2025-12-08T19:35:13.696Z",
    "seller_id": 2565546850,
    "price": 65.99,
    "original_price": 0,
    "currency_id": "USD",
    "net_proceeds": {
        "amount": 38.62,
        "additional_concepts": [
            {
                "id": "shipping_cost",
                "amount": 16.48
            },
            {
                "id": "sale_fee",
                "amount": 10.89
            }
        ],
        "currency_id": "USD"
    },
    "base_exchange_rate": 0,
    "user_logistic_type": "remote",
    "owner_id": 2560656533,
    "cbt_item_id": "CBT2796239245",
    "variations": [],
    "item_relations": []
}
```

--------------------------------

### POST automate by product - Example

Source: https://global-selling.mercadolibre.com/devsite/manage-automations

Example curl command with concrete item ID and catalog product ID. Demonstrates the request format with actual values.

```bash
curl -X POST
'https://api.mercadolibre.com//marketplace/items/MLM5411216524/prices/automate/by-product/MLM29387276' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "rule_id" : "INT",
  "min_price": 100,
  "max_price": 1000
}'
```

--------------------------------

### GET /users/$USER_ID/shipping_options/cost

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Get the shipping cost of a marketplace item. This endpoint returns the final shipping fee, currency, site, billable weight, and free shipping status.

```APIDOC
## GET /users/$USER_ID/shipping_options/cost

### Description
Get the shipping cost of the marketplace items.

### Method
GET

### Endpoint
https://api.mercadolibre.com/users/$USER_ID/shipping_options/cost

### Parameters
#### Path Parameters
- **USER_ID** (string) - Required - The user ID of the seller.

#### Query Parameters
None

#### Request Body
None

### Request Example

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_options/cost


### Response
#### Success Response (200)
- **shipping_fee** (number) - Final shipping cost.
- **currency_id** (string) - Currency of the shipping fee.
- **site_id** (string) - Site identifier.
- **billable_weight** (object) - Weight used to calculate shipping cost.
  - **value** (number) - Weight value.
  - **unit** (string) - Unit of weight.
- **free_shipping** (boolean) - Whether the item has free shipping.

#### Response Example

{
    "shipping_fee": 19.96,
    "currency_id": "USD",
    "site_id": "MLM",
    "billable_weight": {
        "value": 1000,
        "unit": "g"
    },
    "free_shipping": false
}


### Errors
| HTTP Code | Error | Message |
|-----------|-------|---------|
| 403 | forbidden | Invalid caller.id |
| 403 | forbidden | Can not identify the user |
| 404 | not_found_shipping_id | Not found shipping with id: $SHIPMENT_ID |
| 500 | internal_server_error | Oops! Something went wrong... |
| 401 | not_found | invalid_token |
| 400 | bad_request | {"message":"Malformed access_token: TOKEN_NOT_VALID","error":"bad_request","status":400,"cause":[]} |
| 400 | bad_request | Param not valid |
```

--------------------------------

### Inform Not Delivered - Example NOT_DELIVERED

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Reports that the shipment was not delivered to the buyer. The status 'not_delivered' is final and irreversible, and should only be used when there are no more delivery attempts. The response confirms success.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST https://api.mercadolibre.com/marketplace/shipments/28262122315/tracking/status
  -d '{
    "tracking_id": "TKR123",
    "status": "not_delivered"
}'
```

```json
{
    "status": "success"
}
```

--------------------------------

### Get Shipping Label (curl)

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Use this curl command to retrieve the shipping label in PDF format. Requires a valid access token and the shipment ID. The shipment status must be ready_to_ship.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/labels
```

--------------------------------

### Get Working Days - curl request and JSON response

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Retrieves all holiday dates configured for the seller with their current work status. The response includes fields such as `checked`, `closed`, `finalized`, `enabled`, and `mandatory`. Note that when `mandatory` is `true`, the date cannot be modified by the seller regardless of the `checked` value.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -X GET 'https://api.mercadolibre.com/marketplace/sellers/$SELLER_ID/working_days'
```

```json
{
  "dates": [
    {
      "closed": false,
      "finalized": true,
      "enabled": true,
      "checked": true,
      "description": "Rosh Hashanah",
      "date": "2025-09-23"
    },
    {
      "closed": false,
      "finalized": true,
      "enabled": true,
      "checked": false,
      "description": "Yom Kippur",
      "date": "2025-10-01"
    },
    {
      "closed": false,
      "finalized": false,
      "enabled": false,
      "checked": true,
      "mandatory": true,
      "description": "National Holiday",
      "date": "2025-10-15"
    }
  ]
}
```

--------------------------------

### GET /marketplace/shipments/$SHIPMENT_ID

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Retrieves shipment details such as status and buyer address information. Requires the x-format-new: true header.

```APIDOC
## GET /marketplace/shipments/$SHIPMENT_ID

### Description
Retrieves shipment details including status and buyer address information (street, number, zip code, state, country, etc.).

### Method
GET

### Endpoint
https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID

### Parameters
#### Path Parameters
- **$SHIPMENT_ID** (string) - Required - The shipment identifier.

#### Headers
- **Authorization** (string) - Required - Bearer token for authentication.
- **x-format-new** (string) - Required - Must be set to `true`.

### Request Example
```
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' -X GET https://api.mercadolibre.com/marketplace/shipments/40531399184
```

### Response
#### Success Response (200)
- **status** - Shipment status.
- **destination.shipping_address** - Buyer address details (equivalent to the deprecated `receiver_address` field).
- **receiver_phone** - Obfuscated phone number.

#### Response Example
(No explicit response example provided in the source.)

```

--------------------------------

### Check if pack was split with GET /marketplace/orders/pack/$FAMILY_PACK_ID

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Query the original (parent) pack using its family_pack_id. A status_detail of "splitted" and family_pack_id of null confirm the pack was split.

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/orders/pack/$FAMILY_PACK_ID
```

```bash
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/orders/pack/2000008674781009
```

```json
{
  "id": 2000008674781009,
  "status": "cancelled",
  "status_detail": "splitted",
  "family_pack_id": null,
  "orders": [...],
  ...
}
```

--------------------------------

### Get shipment costs with curl

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Use this curl command to fetch the shipment costs for a given shipment ID. Requires an access token and the x-format-new header.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'x-format-new: true' https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/costs
```

--------------------------------

### View available reasons - Example request

Source: https://global-selling.mercadolibre.com/devsite/program-members

Example request using the site ID 'MLA' to retrieve available reasons for that site.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/denounces/MLA/ITM/options
```

--------------------------------

### GET /marketplace/shipments/$SHIPMENT_ID/labels

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Retrieves the shipping label in PDF format for a given shipment ID. The shipment must be in 'ready_to_ship' status. Requires an access token for authentication.

```APIDOC
## GET /marketplace/shipments/$SHIPMENT_ID/labels

### Description
Retrieves the shipping label in PDF format for a given shipment ID. The shipment must be in 'ready_to_ship' status. Requires an access token for authentication.

### Method
GET

### Endpoint
https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/labels

### Parameters
#### Path Parameters
- **$SHIPMENT_ID** (string) - Required - The unique identifier of the shipment.

#### Headers
- **Authorization** (string) - Required - Bearer token for authentication. Format: `Bearer $ACCESS_TOKEN`

### Request Example

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/shipments/$SHIPMENT_ID/labels


### Response
#### Success Response (200)
Returns the shipping label in PDF format.

### Errors
| HTTP Code | Error | Message |
|---|---|---|
| 403 | forbidden | Invalid caller.id |
| 403 | forbidden | Can not identify the user |
| 404 | not_found | Resource not found |
| 404 | Error_Shipment | Mandatory information is missing: IMEI |
| 400 | SHPLAB0218 | INVALID_SHIPMENT_FF_PUBLIC - Labels cannot be generated for Fulfillment shipments through public API |
| 500 | internal_server_error | Oops! Something went wrong... |
| 401 | not_found | invalid_token |
| 400 | bad_request | {"message":"Malformed access_token: TOKEN_NOT_VALID","error":"bad_request","status":400,"cause":[]} |
| 400 | bad_request | Invalid shipment id |
| 401 | not_found | invalid_token |
| 401 | unauthorized_scopes | Unauthorized shipments: 28140669939: Shipment status is 'delivered' |
```

--------------------------------

### curl GET request to retrieve shipment orders

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments

Calls the /shipments/{shipment_id}/orders endpoint with required X-New-Domain:true header and Bearer token.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'X-New-Domain:true' https://api.mercadolibre.com/shipments/$SHIPMENT_ID/orders
```

--------------------------------

### Get shipping cost for a user

Source: https://global-selling.mercadolibre.com/devsite/manage-shipments?nocache=true

Use this curl command to retrieve the shipping cost for a user's items. Replace $ACCESS_TOKEN and $USER_ID with valid values.

```bash
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/shipping_options/cost
```
Tokens:
Raw