Last update 28/12/2022

Users & Apps


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

Resource Description Example
/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.