| /users/{Cust_id}?access_token=$ACCESS_TOKEN |
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=$ACCESS_TOKEN |
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/{Cust_id}/addresses?access_token=$ACCESS_TOKEN |
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/{Cust_id}/accepted_payment_methods=$ACCESS_TOKEN |
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/{application_id}?ACCESS_TOKEN |
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/{Cust_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/{Cust_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}?access_token=$ACCESS_TOKEN |
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.
|
| /myfeeds?app_id={App_id}?access_token=ACCESS_TOKEN |
Notifications history. |
GET
Go back X
Get historic of notifications by app
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/myfeeds?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.
|
