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": []
}
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"
}
}
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.
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.
