Documentation Mercado Libre

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

Documentation

Last update 01/04/2025

Manage users

If you registered your application and authenticated, the next step is to learn how to work with users (sellers and buyers). There are 2 types of users in Global Selling:

  • Global user: is the that has the login to Global Selling and also the grants (get access token) to operate on marketplaces users. Per account, you can have a global user and one or more marketplaces users.
  • Marketplace user: each marketplace user corresponds to each local operation and logistic type set: Mexico Remote, Mexico Fulfillment, Brazil Remote, Chile Fulfillment, Chile Remote and Colombia Remote. The operations for each marketplace user can be managed using the global user’s access token.

As integrator you can operate over all these accounts with just one access token. The operations for each marketplace user can be managed using the global user’s access token. See more the users architecture:


Users & Apps


This examples will help you work with users and applications registered on Global Selling.

Resource Description Example
/users/$USER_ID User account information. GET
PUT
Go back X

Get user information.

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

Response:

{
    "id": 523130418,
    "nickname": "CNTESTNICOCBT",
    "registration_date": "2020-02-05T20:16:58.000-04:00",
    "first_name": "TESTNICOCBT",
    "last_name": "TESTNICOCBT",
    "gender": "",
    "country_id": "CN",
    "email": "testnicocbt@emailna.co",
    "identification": {
        "number": "12345678",
        "type": "TaxID"
    },
    "address": {
        "address": "498 NW 3rd Av",
        "city": "Chongqing",
        "state": "CHONGQING",
        "zip_code": "12345"
    },
    "phone": {
        "area_code": "131",
        "extension": "",
        "number": "23456789",
        "verified": false
    },
    "alternative_phone": {
        "area_code": "",
        "extension": "",
        "number": ""
    },
    "user_type": "normal",
    "tags": [
        "normal",
        "messages_as_seller"
    ],
    "logo": null,
    "points": 0,
    "site_id": "CBT",
    "permalink": "nullCNTESTNICOCBT",
    "seller_experience": "ADVANCED",
    "bill_data": {
        "accept_credit_note": null
    },
    "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
            "canceled": 0,
            "completed": 0,
            "period": "historic",
            "ratings": {
                "negative": 0,
                "neutral": 0,
                "positive": 0
            },
            "total": 0
        },
        "metrics": {
            "sales": {
                "period": "60 months",
                "completed": 0
            },
            "claims": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "delayed_handling_time": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "cancellations": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            }
        }
    },
    "buyer_reputation": {
        "canceled_transactions": 0,
        "tags": [],
        "transactions": {
            "canceled": {
                "paid": null,
                "total": null
            },
            "completed": null,
            "not_yet_rated": {
                "paid": null,
                "total": null,
                "units": null
            },
            "period": "historic",
            "total": null,
            "unrated": {
                "paid": null,
                "total": null
            }
        }
    },
    "status": {
        "billing": {
            "allow": true,
            "codes": []
        },
        "buy": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "confirmed_email": false,
        "shopping_cart": {
            "buy": null,
            "sell": null
        },
        "immediate_payment": false,
        "list": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "mercadoenvios": "not_accepted",
        "mercadopago_account_type": null,
        "mercadopago_tc_accepted": false,
        "required_action": null,
        "sell": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "site_status": "active",
        "user_type": null
    },
    "secure_email": "ttestni.wq2n28@mail.mercadolibre.com",
    "company": {
        "brand_name": "TESTNICOCBT",
        "city_tax_id": null,
        "corporate_name": "TESTNICOCBT",
        "identification": "12345678",
        "state_tax_id": null,
        "soft_descriptor": null
    },
    "credit": {
        "consumed": 0,
        "credit_level_id": "CBT5",
        "rank": "newbie"
    },
    "pwd_generation_status": "none",
    "context": {
        "device": "desktop",
        "flow": "cbt-merchant",
        "source": "mercadolibre"
    }
}
Learn more.
Go backX

Update user information.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X PUT -H "Content-Type: application/json" -d
{
    "identification_type": "TaxID",
    "identification_number": "1234567890",
    "address": "498 NW 3rd Av",
    "city": "Chongqing",
    "state": "CN-CQ",
    "zip_code": "12345",
    "phone": {
        "area_code": "131",
        "number": "234562789",
        "extension": ""
    },
    "first_name": "John",
    "last_name": "Paul",
    "company": {
        "corporate_name": "Acme",
        "brand_name": "Acme Company"
    }


https://api.mercadolibre.com/users/123456789
Learn more.
/users/me Returns account information about the authenticated user. GET
Go back X

Get information about the authenticated in user:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/users/me
 

Response:

{
    "id": 523130418,
    "nickname": "CNTESTNICOCBT",
    "registration_date": "2020-02-05T20:16:58.000-04:00",
    "first_name": "Pedro",
    "last_name": "Picapiedras",
    "gender": "M",
    "country_id": "CN",
    "email": "testnicocbt@emailna.co",
    "identification": {
        "number": "1234567890",
        "type": "TaxID"
    },
    "internal_tags": [
        "developer",
        "cbt_merchant",
        "global_seller"
    ],
    "address": {
        "address": "498 NW 3rd Av",
        "city": "Chongqing",
        "state": "CHONGQING",
        "zip_code": "12345"
    },
    "phone": {
        "area_code": "131",
        "extension": "",
        "number": "234562789",
        "verified": false
    },
    "alternative_phone": {
        "area_code": "",
        "extension": "",
        "number": ""
    },
    "user_type": "normal",
    "tags": [
        "normal",
        "messages_as_seller"
    ],
    "logo": null,
    "points": 0,
    "site_id": "CBT",
    "permalink": "nullCNTESTNICOCBT",
    "shipping_modes": [
        "custom",
        "not_specified"
    ],
    "seller_experience": "ADVANCED",
    "bill_data": {
        "accept_credit_note": null
    },
    "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
            "canceled": 0,
            "completed": 0,
            "period": "historic",
            "ratings": {
                "negative": 0,
                "neutral": 0,
                "positive": 0
            },
            "total": 0
        },
        "metrics": {
            "sales": {
                "period": "60 months",
                "completed": 0
            },
            "claims": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "delayed_handling_time": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "cancellations": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            }
        }
    },
    "buyer_reputation": {
        "canceled_transactions": 0,
        "tags": [],
        "transactions": {
            "canceled": {
                "paid": null,
                "total": null
            },
            "completed": null,
            "not_yet_rated": {
                "paid": null,
                "total": null,
                "units": null
            },
            "period": "historic",
            "total": null,
            "unrated": {
                "paid": null,
                "total": null
            }
        }
    },
    "status": {
        "billing": {
            "allow": true,
            "codes": []
        },
        "buy": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "confirmed_email": false,
        "shopping_cart": {
            "buy": null,
            "sell": null
        },
        "immediate_payment": false,
        "list": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "mercadoenvios": "not_accepted",
        "mercadopago_account_type": null,
        "mercadopago_tc_accepted": false,
        "required_action": null,
        "sell": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "site_status": "active",
        "user_type": null
    },
    "secure_email": "ttestni.wq2n28@mail.mercadolibre.com",
    "company": {
        "brand_name": "Acme Company",
        "city_tax_id": null,
        "corporate_name": "Acme",
        "identification": "12345678",
        "state_tax_id": null,
        "soft_descriptor": null
    },
    "credit": {
        "consumed": 0,
        "credit_level_id": "CBT5",
        "rank": "newbie"
    },
    "pwd_generation_status": "none",
    "context": {
        "device": "desktop",
        "flow": "cbt-merchant",
        "source": "mercadolibre"
    }
}
Learn more.
/users/$USER_ID/addresses Returns addresses registered by the user. GET
Go back X

Get user addresses.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/users/523130418/addresses
 

Response

[
    {
        "id": 1086581840,
        "user_id": 523130418,
        "contact": null,
        "phone": null,
        "address_line": "498 NW 3rd Av",
        "floor": null,
        "apartment": null,
        "street_number": null,
        "street_name": null,
        "zip_code": "12345",
        "city": {
            "id": "Q04tQ1FDaG9uZ3Fpbmc",
            "name": "Chongqing"
        },
        "state": {
            "id": "CN-CQ",
            "name": "Chongqing"
        },
        "country": {
            "id": "CN",
            "name": "China"
        },
        "neighborhood": {
            "id": null,
            "name": null
        },
        "municipality": {
            "id": null,
            "name": null
        },
        "search_location": {
            "state": {
                "id": null,
                "name": null
            },
            "city": {
                "id": null,
                "name": null
            },
            "neighborhood": {
                "id": null,
                "name": null
            }
        },
        "types": [
            "billing",
            "default_selling_address",
            "shipping"
        ],
        "comment": null,
        "between": null,
        "references": null,
        "aditional_info": null,
        "geolocation_type": null,
        "geolocation_last_updated": null,
        "geolocation_source": null,
        "latitude": null,
        "longitude": null,
        "status": "active",
        "date_created": "2020-02-05T20:20:13.000-04:00",
        "normalized": true,
        "open_hours": null
    },
    {
        "id": 1086580905,
        "user_id": 523130418,
        "contact": null,
        "phone": null,
        "address_line": "498 NW 3rd Av",
        "floor": null,
        "apartment": null,
        "street_number": null,
        "street_name": null,
        "zip_code": "12345",
        "city": {
            "id": "Q04tQ1FDaG9uZ3Fpbmc",
            "name": "Chongqing"
        },
        "state": {
            "id": "CN-CQ",
            "name": "Chongqing"
        },
        "country": {
            "id": "CN",
            "name": "China"
        },
        "neighborhood": {
            "id": null,
            "name": null
        },
        "municipality": {
            "id": null,
            "name": null
        },
        "search_location": {
            "state": {
                "id": null,
                "name": null
            },
            "city": {
                "id": null,
                "name": null
            },
            "neighborhood": {
                "id": null,
                "name": null
            }
        },
        "types": [
            "shipping_remote"
        ],
        "comment": null,
        "between": null,
        "references": null,
        "aditional_info": null,
        "geolocation_type": null,
        "geolocation_last_updated": null,
        "geolocation_source": null,
        "latitude": null,
        "longitude": null,
        "status": "active",
        "date_created": "2020-02-05T20:20:13.000-04:00",
        "normalized": true,
        "open_hours": null
    }
]
Learn more.
/users/$USER_ID/accepted_payment_methods Returns payment methods accepted by a seller to collect its operations. GET
Go back X

Get accepted payment methods by user.

curl -X GET https://api.mercadolibre.com/users/523132944/accepted_payment_methods
 

Response

[
    {
        "id": "visa",
        "name": "Visa",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif"
    },
    {
        "id": "amex",
        "name": "American Express",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/amex.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/amex.gif"
    },
    {
        "id": "master",
        "name": "Mastercard",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/master.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/master.gif"
    },
    {
        "id": "debmaster",
        "name": "Mastercard Débito",
        "payment_type_id": "debit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/debmaster.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/debmaster.gif"
    },
    {
        "id": "debvisa",
        "name": "Visa Débito",
        "payment_type_id": "debit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/debvisa.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/debvisa.gif"
    },
    {
        "id": "mercadopagocard",
        "name": "Tarjeta MercadoPago",
        "payment_type_id": "prepaid_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/mercadopagocard.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/mercadopagocard.gif"
    },
    {
        "id": "serfin",
        "name": "Santander",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2016.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2016.gif"
    },
    {
        "id": "oxxo",
        "name": "OXXO",
        "payment_type_id": "ticket",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2017.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2017.gif"
    },
    {
        "id": "account_money",
        "name": "Dinero en mi cuenta de MercadoPago",
        "payment_type_id": "account_money",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2018.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2018.gif"
    },
    {
        "id": "bancomer",
        "name": "BBVA Bancomer",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2014.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2014.gif"
    },
    {
        "id": "banamex",
        "name": "Citibanamex",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2015.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2015.gif"
    },
    {
        "id": "consumer_credits",
        "name": "Mercado Crédito",
        "payment_type_id": "digital_currency",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/consumer_credits.gif",
        "secure_thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/consumer_credits.gif"
    }
]
Learn more.
/applications/$APP_ID Returns information about the application. GET
Go back X

Get application details.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/applications/6098792155457031
 

Response

{
    "id": 6098792155457031,
    "site_id": "CBT",
    "name": "Test application to Global Selling operation",
    "description": "Test application ",
    "thumbnail": null,
    "catalog_product_id": null,
    "item_id": null,
    "price": null,
    "currency_id": null,
    "short_name": "TestAppGsInt",
    "url": "http://globalselling.mercadolibre.com/devcenter/testappgsint",
    "callback_url": "https://test.com",
    "sandbox_mode": true,
    "project_id": null,
    "active": true,
    "max_requests_per_hour": 18000,
    "scopes": [
        "offline_access",
        "read",
        "write"
    ],
    "domains": [],
    "certification_status": "not_certified"
}
Learn more.
/users/$USER_ID/brands This resource retrieves brands associated to an user_id. The official_store_id attribute identifies a store. GET
Go back X

Get brands by user.

curl -X GET https://api.mercadolibre.com/users/470225786/brands
 

Response

{
    "cust_id": 470225786,
    "site_id": "MLM",
    "user_type": "brand",
    "tags": [
        "brand",
        "large_seller"
    ],
    "brands": [
        {
            "official_store_id": 2572,
            "site_id": "MLM",
            "name": "Hyiear",
            "fantasy_name": "Hyiear",
            "type": "normal",
            "status": "active",
            "permalink": "https://tienda.mercadolibre.com.mx/hyiear",
            "date_created": "2020-01-14T17:51:22Z",
            "relevance_position": 10000,
            "main_categories": [
                {
                    "id": "MLM1575"
                }
            ],
            "pictures": [
                {
                    "id": 88531,
                    "name": "logo",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo202001130546.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo202001130546.jpg",
                    "size": "160x80"
                },
                {
                    "id": 88532,
                    "name": "logo_landing",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo_landing202001130546.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo_landing202001130546.jpg",
                    "size": "160x80"
                },
                {
                    "id": 88533,
                    "name": "background",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background202001130546.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background202001130546.jpg",
                    "size": "1600x750"
                },
                {
                    "id": 88534,
                    "name": "background_home",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background_home202001130547.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background_home202001130547.jpg",
                    "size": "780x190"
                },
                {
                    "id": 88535,
                    "name": "small_logo",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/small_logo202001130547.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/small_logo202001130547.jpg",
                    "size": "96x70"
                },
                {
                    "id": 88536,
                    "name": "big_logo",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/big_logo202001130547.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/big_logo202001130547.jpg",
                    "size": "174x164"
                },
                {
                    "id": 88537,
                    "name": "facebook_logo",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/facebook_logo202001130546.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/facebook_logo202001130546.jpg",
                    "size": "200x200"
                },
                {
                    "id": 88538,
                    "name": "high_resolution_logo",
                    "secure_url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/high_resolution_logo202001130547.jpg",
                    "url": "https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/high_resolution_logo202001130547.jpg",
                    "size": "1024x747"
                },
                {
                    "id": 88539,
                    "name": "dynamic_logo",
                    "secure_url": "https://http2.mlstatic.com/D_Q_NP_842479-MLA40418375094_012020-F.jpg",
                    "url": "http://mla-s1-p.mlstatic.com/842479-MLA40418375094_012020-F.jpg",
                    "size": "1024x747"
                }
            ],
            "tags": [],
            "categories_ids": [
                "MLM1575"
            ],
            "return_policy": null,
            "landing_permalink": null
        }
    ]
}
Learn more.
/users/$USER_ID/available_listing_types?category_id=$CATEGORY_ID Listing types availability by user and category. GET
Go back X

Get promotions packs engaged by user.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/users/523130418/available_listing_types?categoryId=CBT11796
 

Response

{
    "category_id": "CBT11796",
    "available": [
        {
            "site_id": "CBT",
            "id": "gold_pro",
            "name": "Premium",
            "remaining_listings": null
        }
    ]
}
Learn more.
/users/$USER_ID/available_listing_type/$LISTING_TYPE_ID?category_id=$CATEGORY_ID Retrieves availability to list under a listing type for a given category. GET
Go back X

Get listing exposures by site.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/users/523130418/available_listing_type/gold_special?category_id=CBT11796
 

Response

{
    "available": false,
    "cause": "This listing type is not available for global sellers.",
    "code": "cbt.listing_type.unavailable"
}
Learn more.
/users/$USER_ID/applications/$APP_ID Application permissions. DELETE
Go back X

Revoke permissions to an application.

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X DELETE https://api.mercadolibre.com/users/$CUST_ID/applications/$APP_ID
Learn more.
/missed_feeds?app_id=$APP_ID Notifications history. GET
Go back X

Get historic of notifications by app

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/missed_feeds?app_id=$APP_ID
Learn more.
/marketplace/users/$USER_ID User mapping with its corresponding marketplace user detail. GET
Go back X

Get the mapping of a user and its corresponding marketplace:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/marketplace/users/471826944
 

Response

{
    "user_id": 471826944,
    "site_id": "CBT",
    "marketplaces": [
        {
            "user_id": 471828584,
            "site_id": "MLM",
            "logistic_type": "remote"
        },
        {
            "user_id": 471830260,
            "site_id": "MLB",
            "logistic_type": "remote"
        },       
        {
            "user_id": 538932857,
            "site_id": "MLC",
            "logistic_type": "remote"
        }
    ]
}
Learn more.

Get personal information


If you are logged in Mercado Libre and have a token, you will be able to make the request below and learn about your user-related information:

Request:

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

Response:

{
    "id": 701124911,
    "nickname": "MLMCBT",
    "registration_date": "2021-01-13T13:35:17.000-04:00",
    "first_name": "Test",
    "last_name": "Test",
    "gender": "",
    "country_id": "US",
    "email": "maca1122334455@test.com",
    "identification": {
        "number": "ABC123",
        "type": "TaxID"
    },
    "address": {
        "address": "498 NW 3rd Av",
        "city": "Akiachak",
        "state": "US-AK",
        "zip_code": "2233333"
    },
    "phone": {
        "area_code": "01",
        "extension": "",
        "number": "1111-1111",
        "verified": false
    },
    "alternative_phone": {
        "area_code": "",
        "extension": "",
        "number": ""
    },
    "user_type": "normal",
    "tags": [
        "normal",
        "test_user",
        "messages_as_seller"
    ],
    "logo": null,
    "points": 100,
    "site_id": "CBT",
    "permalink": "nullMLMCBT",
    "seller_experience": "ADVANCED",
    "bill_data": {
        "accept_credit_note": null
    },
    "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
            "canceled": 0,
            "completed": 0,
            "period": "historic",
            "ratings": {
                "negative": 0,
                "neutral": 0,
                "positive": 0
            },
            "total": 0
        },
        "metrics": {
            "sales": {
                "period": "60 months",
                "completed": 0
            },
            "claims": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "delayed_handling_time": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "cancellations": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            }
        }
    },
    "buyer_reputation": {
        "canceled_transactions": 0,
        "tags": [],
        "transactions": {
            "canceled": {
                "paid": null,
                "total": null
            },
            "completed": null,
            "not_yet_rated": {
                "paid": null,
                "total": null,
                "units": null
            },
            "period": "historic",
            "total": null,
            "unrated": {
                "paid": null,
                "total": null
            }
        }
    },
    "status": {
        "billing": {
            "allow": true,
            "codes": []
        },
        "buy": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "confirmed_email": true,
        "shopping_cart": {
            "buy": null,
            "sell": null
        },
        "immediate_payment": false,
        "list": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "mercadoenvios": "not_accepted",
        "mercadopago_account_type": "personal",
        "mercadopago_tc_accepted": true,
        "required_action": null,
        "sell": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "site_status": "active",
        "user_type": null
    },
    "secure_email": "ttest.h6rdpb@mail.mercadolibre.com",
    "company": {
        "brand_name": "TESTACMECOMPANY",
        "city_tax_id": "",
        "corporate_name": "TESTACMECOMPANY",
        "identification": "12345678",
        "state_tax_id": "",
        "cust_type_id": "BU",
        "soft_descriptor": null
    },
    "credit": {
        "consumed": 0,
        "credit_level_id": "CBT5",
        "rank": "newbie"
    },
    "pwd_generation_status": "none",
    "context": {
        "ip_address": "200.0.0.0"
    },
    "registration_identifiers": []
}

Get public global user information

Now, as you already know the user ID, you can make a request to the users’ resource as shown below in order to get the public information of the user you want:

Request:

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

Example:

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

Response:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
  "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
  "normal",
  "test_user",
  "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "seller_reputation": {
  "level_id": null,
  "power_seller_status": null,
  "transactions": {
    "period": "historic",
    "total": 0,
    "completed": 0,
    "canceled": 0,
    "ratings": {
      "positive": 0,
      "negative": 0,
      "neutral": 0
    }
  }
  },
  "buyer_reputation": {
  "tags": [
  ]
  },
  "status": {
  "site_status": "active"
  }
}

Get private global user information

Now, as you already know the user ID, you can make a request to the users’ resource as shown below in order to get the public information of the user you want:

Request:

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

Example:

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

Response:

{
    "id": 526124693,
    "nickname": "CNMOLMEDOTESTCBT",
    "registration_date": "2020-02-12T09:43:00.000-04:00",
    "first_name": "molmedotestcbt",
    "last_name": "MolmedoTestCBTOP",
    "gender": "",
    "country_id": "CN",
    "email": "6bdb83c0d0@emailtown.club",
    "identification": {
        "number": "12345678",
        "type": "TaxID"
    },
    "address": {
        "address": "false street 1212",
        "city": "Chongqing",
        "state": "CHONGQING",
        "zip_code": "22344"
    },
    "phone": {
        "area_code": null,
        "extension": "",
        "number": "5032423424242",
        "verified": false
    },
    "alternative_phone": {
        "area_code": "",
        "extension": "",
        "number": ""
    },
    "user_type": "normal",
    "tags": [
        "normal",
        "messages_as_seller"
    ],
    "logo": null,
    "points": 0,
    "site_id": "CBT",
    "permalink": "nullCNMOLMEDOTESTCBT",
    "shipping_modes": [
        "custom",
        "not_specified"
    ],
    "seller_experience": "ADVANCED",
    "bill_data": {
        "accept_credit_note": null
    },
    "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
            "canceled": 0,
            "completed": 0,
            "period": "historic",
            "ratings": {
                "negative": 0,
                "neutral": 0,
                "positive": 0
            },
            "total": 0
        },
        "metrics": {
            "sales": {
                "period": "60 months",
                "completed": 0
            },
            "claims": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "delayed_handling_time": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            },
            "cancellations": {
                "period": "60 months",
                "rate": 0,
                "value": 0
            }
        }
    },
    "buyer_reputation": {
        "canceled_transactions": 0,
        "tags": [],
        "transactions": {
            "canceled": {
                "paid": null,
                "total": null
            },
            "completed": null,
            "not_yet_rated": {
                "paid": null,
                "total": null,
                "units": null
            },
            "period": "historic",
            "total": null,
            "unrated": {
                "paid": null,
                "total": null
            }
        }
    },
    "status": {
        "billing": {
            "allow": true,
            "codes": []
        },
        "buy": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "confirmed_email": false,
        "shopping_cart": {
            "buy": null,
            "sell": null
        },
        "immediate_payment": false,
        "list": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "mercadoenvios": "not_accepted",
        "mercadopago_account_type": null,
        "mercadopago_tc_accepted": false,
        "required_action": null,
        "sell": {
            "allow": true,
            "codes": [],
            "immediate_payment": {
                "reasons": [],
                "required": false
            }
        },
        "site_status": "active",
        "user_type": null
    },
    "secure_email": "mmolmed.hgxgj0@mail.com",
    "company": {
        "brand_name": "molmedotestcbt",
        "city_tax_id": "",
        "corporate_name": "MolmedoTestCBTOP",
        "identification": "12345678",
        "state_tax_id": "",
        "cust_type_id": "BU",
        "soft_descriptor": null
    },
    "credit": {
        "consumed": 0,
        "credit_level_id": "CBT5",
        "rank": "newbie"
    },
    "pwd_generation_status": "none",
    "context": {
        "device": "desktop",
        "flow": "cbt-merchant",
        "source": "mercadolibre"
    }
}

As you can see, this time you got more information about the user: full name, e-mail, telephone, address, etc. Please do not disclose this data since it may jeopardize the user.


Update global user information

To update your user information, follow the next request:

Request:

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

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
    "first_name": "Mister X"
}
https://api.mercadolibre.com/users/526124693

Response:

{
    "user_id": 526124693
}

Remember to only send the fields you want to update.


Next: Test users.