Users

Returns information about MercadoLibre users. Private attributes are displayed only if the user is authenticated and authorized.

collapse allexpand all

[
]
Allowed methods
Returns information about MercadoLibre users. Some attributes are only displayed if the user is logged.
GET
/users/:id
Returns information about MercadoLibre logged user
GET
/users/me/
Returns information from a list of MercadoLibre users.
GET
/users/:ids=id,id...,id
Attributes
id
User ID
nickname
User Nickname
registration_date
User registration date on site
first_name
First Name
last_name
Last Name
country_id
Country ID
email
User electronic email
identification
Personal identification
Attributes
identification_type
Type
identification_number
Number
phone
User Phone
Attributes
area_code
Area code
number
Number
verified
Indicates whether the phone was checked
user_type
User type. It can be:
Attributes
car_dealer
Car dealer
real_estate_agency
Real state agency
branch
Branch
franchise
Franchise
brand
Brand
normal
Normal
logo
Real state agency or car dealer logo
points
Points
site_id
Site ID
permalink
User URL
seller_experience
Experience as seller. It can be:
Attributes
newbie
Newbie
intermediate
Intermediate
advanced
Advanced
seller_reputation
Reputation as seller
Attributes
level_id
Thermometer location as seller. It can be:
Attributes
1_red
Red
2_orange
Orange
3_yellow
Yellow
4_light_green
Light green
5_green
Green
null (null value)
Without level.
power_seller_status
MercadoLíder Level. It can be:
Attributes
silver
Silver
gold
Gold
platinum
Platinum
null (null value)
Without level.
transactions
Sales made
Attributes
period
Time period taken to evaluate its reputation. It can be:
Attributes
historic
historic
12 months
Last 12 months
3 months
Last 3 months
total
Total sales
completed
Completed sales
canceled
Sales Cancelled
ratings
Rated sales
Attributes
positive
Positive ratings percentage
negative
Negative ratings percentage
neutral
Neutral ratings percentage
metrics
Sales metrics
Attributes
sales
Metric of completed sales
Attributes
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
historic
historic
3 months
Last 3 months
completed
Completed sales in the period
claims
Metric of sales with claims
Attributes
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
historic
historic
3 months
Last 3 months
rate
The rate between received claims and the completed transactions in the period
delayed_handling_time
Metric of sales with delayed handling time
Attributes
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
historic
historic
3 months
Last 3 months
rate
The rate between sales with delayed handling time and sales done with ME in the period
buyer_reputation
Reputation as buyer
Attributes
transactions
Purchases made
Attributes
period
Time period taken to evaluate its reputation.
total
Total purchases
completed
Purchases completed
canceled
Purchases canceled
Attributes
total
Total purchases
paid
Total paid purchases
unrated
Unrated purchases
Attributes
total
Total purchases
paid
Total paid purchases
not_yet_rated
Purchases under rating period
Attributes
total
Total purchases
paid
Total paid purchases
status
User status
Attributes
site_status
General status of the user on the site. It can be:
Attributes
active
Active user
pending
Pending e-mail confirmation
deactive
Deactive user
list
To List
Attributes
allow
Specifies whether the user is allowed to post new items
codes
Error Codes. It may be more than one:
Attributes
feedback_restriction
Indicates that the user is restricted by Feedback
has_debt
Indicates that the user has MercadoLibre debt
credit_limit_exeeded
Indicates that the user exceeded his credit limit
internal_control
Indicates that the user is under internal control
historical_behaviour
Indicates that the user has an incorrect historical behavior
mercadopago_restrictions
Indicates that the user has a restriction imposed by MercadoPago
buy
To Buy
Attributes
allow
Indicates whether the user is allowed to buy items
codes
Error Codes. It may be more than one:
Attributes
internal_control
Indicates that the user is under internal control
historical_behaviour
Indicates that the user has an incorrect historical behavior
mercadopago_restrictions
Indicates that the user has a restriction imposed by MercadoPago
sell
To Sell
Attributes
allow
Indicates whether the user is allowed to sell the items that has listed
codes
Error Codes. It may be more than one:
Attributes
feedback_restriction
Indicates that the user is restricted by Feedback
has_debt
Indicates that the user has MercadoLibre debt
credit_limit_exeeded
Indicates that the user exceeded his credit limit
mercadopago_tc_accepted
Indicates if the user accepts the terms and conditions of MercadoPago
immediate_payment
Indicates whether the user has to pay with credit card to buy. It can be:
Attributes
required
Required
optional
Optional
credit
User Credit Level
Attributes
consumed
Credit consumed by the user
credit_level_id
Credit level ID
personal_information
User personal info
Attributes
first_name
First Name
last_name
Last Name
person_mothers_name
Person mothers name
person_birthdate
Person birthdate
person_birthplace
Person birthplace
taxpayer_number
Taxpayer number
company_name
Company Name
company_main_activity
Company main activity
company_type
Company type
company_establishment_date
Company establishment date
company_rep
Company agent
Attributes
id
Number
name
Name
identification
Personal identification
Attributes
identification_type
Type
identification_number
Number
phone
User Phone
Attributes
area_code
Area code
number
Number
verified
Indicates whether the phone was checked
address
User address
Attributes
state
state
city
city
address
address
zip_code
zip code
Related resources
/sites