The profiles/my method is an Elance Developer API Profiles method that requests details for the currently authenticated contractor.

This method will return an error (see "Error Codes" below) if the user authenticated using OAuth 2 does not have a contractor profile on Elance. To obtain public profile information on another contractor, use the profiles/{nameOrId} method.

This method must be called using an HTTPS GET request. All responses are returned in the JSON format.

I. Preconditions

This method requires that the calling application has authenticated a user using the OAuth 2.0 protocol, as described on the Getting Started page.

II. Required URL Parameters

There are no required URL parameters for this method.

III. Optional Query String Parameters

Parameter Description
catId The ID of the Elance service category for which to retrieve profile information. This value determines which job and testimonial objects are returned. Valid values are listed in the table below.

1. Valid Category ID Values

Value Category Name
10178 Sales & Marketing
10179 Admin Support
10180 Writing & Translation
10183 Web & Programming
10184 Design & Multimedia
10186 Finance & Management
10187 Legal
14000 Engineering & Manufacturing

IV. Response Data Description

Property Name Data Type Description
providerProfile ProviderProfileData object The wrapper label for the profile information described below.
userId integer The unique ID, assigned by Elance, that designates the user to whom this profile belongs.
userName string The unique text string, chosen by the user, that the employer or contractor uses to log in to Elance.
businessName string The name of the contractor's company, if applicable. If the contractor is an individual, this string will represent his or her real name.
companyUserId string The unique ID assigned to this contractor as a member of a company. If not applicable, this field will be null.
companyLoginName string The unique text string used by the contractor to log in as a member of a company. If not applicable, this field will be null.
companyBusinessName string The name of the company to which this contractorr belongs. If not applicable, this field will be null.
tagLine string A brief description of the contractor's services, supplied by the contractor.
overview string A full description of the contractor's background and services, supplied by the contractor.
hourlyRate decimal The average price the contractor charges per hour for hourly jobs.
isIndividual boolean True if this contractor is a personal contractor with no business or corporate identity; otherwise, false.
isWatched boolean True if the contractor is one the currently logged in user's Watch list; otherwise, false.
isStaff boolean True if this contractor is a staff member of a larger corporate entity on Elance; otherwise, false.
city string The city in which the contractor resides.
state string The state or province in which the contractor resides.
country string The country in which the contractor resides.
countryCode string The alpha-2 country code for the contractor's country of residence, as specified by ISO 3166-1.
profileType ProfileTypeData object Designates whether this is an individual or business account. Includes identifying information for the particular entity, such as a personal photo or company logo.
skills SkillsData object A zero-based array describing the contractor's technical and professional proficiencies.
skillsCount integer The number of competencies and specialties the contractor or business possesses. Corresponds to the number of entries returned in the skills property.
portfolioCount integer The number of documents, code projects, or other work products uploaded by the contractor to showcase his or her work. Corresponds to the number of objects returned in the portfolio property.
privateEarnings boolean True if the total amount earned on Elance by this contractor is kept hidden; otherwise, false.
earnings6Months integer (JSON string) The total amount, in US dollars, that the contractor has received in payment during the past six months.
feedback6Months integer (JSON string) The number of ratings left for this contractor over the past six months.
posFeedback6Months integer (JSON string) The number of positive ratings received by this contractor over the past six months.
avgFeedbackScore6Months integer (JSON string) The average employer rating of this contractor over the past six months.
earnings12Months integer (JSON string) The total amount, in US dollars, that the contractor has received in payment during the past 12 months.
feedback12Months integer (JSON string) The number of ratings left for this contractor over the past 12 months.
jobs12Months integer (JSON string) The number of bids this contractor has been awarded in the past 12 months.
posFeedback12Months integer (JSON string) The number of positive ratings received by this contractor over the past 12 months.
avgFeedbackScore12Months integer (JSON string) The average employer rating of this contractor over the past 12 months.
elanceLevel integer (JSON string) The contractor's level rating on Elance.
category string ??
userCategories Array of UserCategoryData objects A list of the categories to which the contractor belongs.
logo string The URL to the contractor's business image or personal picture.
providerProfileURL string The full URL to the contractor's profile on Elance.
providerJobHistoryURL string The full URL to the contractor's list of in-progress and completed jobs on Elance.
providerPortfolioURL string The full URL to the contractor's list of example work artifacts, such as documents and code samples.
earnings integer (JSON string) The total amount, in US dollars, that the contractor has received in payment through his or her tenure on Elance.
feedback integer (JSON string) The total number of reviews left for the contractor through his or her tenure on Elance.
posFeedback integer (JSON string) The number of positive ratings given to this contractor through his or her tenure on Elance.
avgFeedbackScore integer (JSON string) The average employer rating of this contractor through his or her tenure on Elance.
clients6Months integer (JSON string) The number of unique employers who have chosen this contractor over the past six months.
clients integer (JSON string) The total number of clients for whom this contractor has worked during his or her tenure on Elance.
RepeatClients integer (JSON string) The total number of clients who have hired this contractor two or more times during the contractor's tenure on Elance.
RepeatClients6Months integer (JSON string) The total number of clients who have hired this contractor two or more times during the past six months.
RepeatClients12Months integer (JSON string) The total number of clients who have hired this contractor two or more times during the past 12 months.
RepeatClientsPct integer (JSON string) The percentage of clients who have hired this contractor two or more times during the contractor's tenure on Elance.
RepeatClientsPct6Months integer (JSON string) The percentage of clients who have hired this contractor two or more times during the past six months.
RepeatClientsPct12Months integer (JSON string) The percentage of clients who have hired this contractor two or more times during the past 12 months.
jobs6Months integer (JSON string) The number of bids this contractor has been awarded during the past six months.
jobs integer (JSON string) The number of bids this contractor has been awarded during his or her tenure on Elance.
milestones6Months integer (JSON string) The number of project deliverable dates that have been met by the contractor during the past six months.
milestones integer (JSON string) The number of project deliverable dates that have been met by the contractor during his or her tenure on Elance.
hoursWorked6Months integer (JSON string) The number of hours the contractor has logged on hourly Elance projects in the past six months.
hoursWorked integer (JSON string) The number of hours the contractor has logged on hourly Elance projects during his or her tenure on Elance.
earningsPerClient integer (JSON string) The average amount (in US dollars) that the contractor has been paid by individual employers during the contractor's tenure on Elance.
earningsPerClient6Months integer (JSON string) The average amount (in US dollars) that the contractor has been paid by individual employers during the past six months.
earningsPerClient12Months integer (JSON string) The average amount (in US dollars) that the contractor has been paid by individual employers during the past 12 months.
clients12Months integer (JSON string) The number of unique employers who have chosen this contractor over the past 12 months.
milestones12Months integer (JSON string) The number of project deliverable dates that have been met by the contractor during the past 12 months.
hoursWorked12Months integer (JSON string) The number of hours the contractor has logged on hourly Elance projects in the past 12 months.
endorsement string The number of times an employer has left a high feedback score for this contractor during the contractor's tenure on Elance.
endorsement6Months string The number of times an employer has left a high feedback score for this contractor during the past six months.
endorsement12Months string The number of times an employer has left a high feedback score for this contractor during the past 12 months.
latestJobs Array of LatestJobsData objects A list of the bids most recently awarded to the contractor.
portfolio Array of PortfolioData objects A list of the past work products and other files showcased by the contractor.
timeZoneData TimeZoneData object An object describing the current time zone.

1. SkillsData Object Description

Property Name Data Type Description
skillId integer The unique ID, assigned by Elance, that identifies a standard skill. If the value of the proficiencyType property is SELF-RATED, this property will be null.
name string The human-readable label that identifies the skill.
proficiencyType string Specifies how the contractor's skill was assessed. Valid values are SELF-RATED and TESTED.
proficiency integer (JSON string) The provider's proficiency score, on a scale from 1 to 10.
testAverage integer (JSON string) The average score for this test obtained across all test takers. If the value of the proficiencyType property is SELF-RATED, this property will be null.
testPercentile integer (JSON string) The provider's test score ranking compared to all other test takers. If the value of the proficiencyType property is SELF-RATED, this property will be null.

2. ProfileTypeData Object Description

Property Name Data Type Description
name string Designates whether this is an individual or business profile. Valid values are Individual and Company.
icon string A URL or element of HTML/CSS markup that displays an image representing the profile type.
iconTooltip string The text string that shold be displayed when a user hovers a mouse over the icon (as described by the icon property).
code string Designates whether this profile belongs to an individual user, or to a user who belongs to a business. Valid values are biz (for a business user) and indiv (for an individual user).

3. UserCategoryData Object Description

Property Name Data Type Description
id integer (JSON string) The unique ID, assigned by Elance, that designates this category.
name string The human-readable text that describes this category (e.g., "IT and Programming").

4. LatestJobsData Object Description

Property Name Data Type Description
jobId integer (JSON string) The unique ID assigned by Elance to this job.
name string A human-readable description of the project, as chosen by the employer.
startDate string The day on which the contractor started work on the project.
bidAmount decimal (JSON string) The total cost of the job, in US dollars, as submitted by the contractor.
scoreOverall integer (JSON string) The rating awarded by the employer to the contractor for this job. If the employer has not yet awarded a rating, this property is omitted from the response.
subcategory string The second level of categorization assigned to this job by the employer.
status integer (JSON string) The current state of the job.
budget string The range of acceptable monetary bids for this project, as originally submitted by the employer.
jobURL string The path on the Elance.com Web site containing the full description and list of available actions for the project.

5. PortfolioData Object Description

Property Name Data Type Description
url string A pointer to the image that represents the work product on the Elance site.
name string The title of the work product, as supplied by the contractor.
description string A summary of the work product's contents, as supplied by the contractor.
tags string A list of terms, separated by spaces, that further specify the content of the work item.
websiteurl string The Internet location of the Web site associated with this work product, as supplied by the contractor.
fullurl string The location on Elance of the uploaded work product.

6. TestimonialData Object Description

Property Name Data Type Description
buyerName string The Elance username of the employer who left the testimonial.
buyerProfileURL string The location of the employer's personal information page on Elance.com.
comments string The free-form text feedback left by the employer.

7. TimeZoneData Object Description

Property Name Data Type Description
name string The identifier for the time zone, usually consisting of a country name followed by a city name - for example, "America/New_York".
gmt_offset string The number of hours, positive or negative, by which the time zone differs from Greenwich Mean Time. A value of "-5:00", for example, signifies the Eastern time zone in the United States.
city string The common name of the time zone.

V. Request/Response Examples in JSON

1. Requesting Contractor Profile Information

A. Request

The following URL requests detailed information on the currently authenticated contractor.

https://api.elance.com/api2/profiles/my?access_token=4eb1de8bf06b10210e000005|3784252|BFEvZuqFVmSUQ9b9elkGHQ

B. Response

{
    "data": {
        "providerProfile": {
            "userId": "4124672",
            "userName": "t_mosby",
            "businessName": "Ted Mosby",
            "companyUserId": null,
            "companyLoginName": null,
            "companyBusinessName": null,
            "tagLine": "Professional PHP Development",
            "overview": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
            "hourlyRate": "33",
            "isIndividual": true,
            "isWatched": false,
            "isStaff": false,
            "city": "Seattle",
            "state": "WA",
            "country": "United States",
            "countryCode": "US",
            "profileType": {
                "name": "Individual",
                "icon": "<div class="sprProfImg sprProf-individual-icon-xxxsmall-free"><!-- --><\/div>",
                "fullName": "Basic Individual",
                "code": "indiv"
            },
            "skills": {
                "0": {
                    "skillId": null,
                    "name": "php",
                    "proficiencyType": "SELF_ASSESSED",
                    "proficiency": "8",
                    "testAverage": null,
                    "testPercentile": null
                },
                "1": {
                    "skillId": null,
                    "name": "apache",
                    "proficiencyType": "SELF_ASSESSED",
                    "proficiency": "8",
                    "testAverage": null,
                    "testPercentile": null
                },
                "2": {
                    "skillId": null,
                    "name": "mysql",
                    "proficiencyType": "SELF_ASSESSED",
                    "proficiency": "8",
                    "testAverage": null,
                    "testPercentile": null
                },
                "3": {
                    "skillId": null,
                    "name": "ruby",
                    "proficiencyType": "SELF_ASSESSED",
                    "proficiency": "8",
                    "testAverage": null,
                    "testPercentile": null
                },
                "4": {
                    "skillId": null,
                    "name": "ruby on rails",
                    "proficiencyType": "SELF_ASSESSED",
                    "proficiency": "8",
                    "testAverage": null,
                    "testPercentile": null
                }
            },
            "skillsCount": 5,
            "portfolioCount": 0,
            "privateEarnings": false,
            "earnings6Months": "0",
            "feedback6Months": "0",
            "posFeedback6Months": "0",
            "avgFeedbackScore6Months": "0.0",
            "earnings12Months": "0",
            "feedback12Months": "0",
            "jobs12Months": "2",
            "posFeedback12Months": null,
            "avgFeedbackScore12Months": "0.0",
            "elanceLevel": null,
            "category": "All Categories",
            "userCategories": [{
                "id": "10183",
                "name": "IT & Programming"
            }],
            "logo": "https:\/\/elance.com\/media\/images\/4.0\/no-photo-64x80.jpg",
            "providerProfileURL": "https:\/\/elance.com\/s\/t_mosby\/",
            "providerJobHistoryURL": "https:\/\/elance.com\/s\/t_mosby\/job-history\/",
            "providerPortfolioURL": "https:\/\/elance.com\/s\/t_mosby\/portfolio",
            "earnings": "0",
            "feedback": "0",
            "posFeedback": "0",
            "avgFeedbackScore": "0.0",
            "clients6Months": "0",
            "clients": "0",
            "repeatClients": "0",
            "RepeatClients": "0",
            "repeatClients6Months": "0",
            "repeatClients12Months": "0",
            "repeatClientsPct": 0,
            "repeatClientsPct6Months": 0,
            "repeatClientsPct12Months": 0,
            "jobs6Months": "2",
            "jobs": "2",
            "milestones6Months": "0",
            "milestones": "0",
            "hoursWorked6Months": "0",
            "hoursWorked": "0",
            "earningsPerClient": 0,
            "earningsPerClient6Months": 0,
            "earningsPerClient12Months": 0,
            "clients12Months": "0",
            "milestones12Months": "0",
            "hoursWorked12Months": "0",
            "endorsement": "N\/A",
            "endorsement6Months": "N\/A",
            "endorsement12Months": "N\/A",
            "latestJobs": {
                "0": {
                    "jobId": 30561768,
                    "name": "PHP Development Required ASAP",
                    "budget": " $1,000 - $5,000",
                    "budgetMin": "1000",
                    "budgetMax": "5000",
                    "startDate": "05\/22\/2012",
                    "feedbackDate": 1337659200,
                    "bidAmount": "0",
                    "isHourly": 0,
                    "subcategory": "Web Programming",
                    "status": "Working",
                    "timeLeft": "Closed",
                    "jobURL": "https:\/\/elance.com\/j\/php-development-required-asap\/30561768\/"
                },
                "1": {
                    "jobId": 30561771,
                    "name": "Hourly PHP Project",
                    "budget": "$40 - $50 \/ hr",
                    "budgetMin": "1200",
                    "budgetMax": "2000",
                    "startDate": "05\/22\/2012",
                    "feedbackDate": 1337659200,
                    "bidAmount": "0",
                    "isHourly": 1,
                    "hourlyRateCode": "14224",
                    "hourlyRateMin": "40",
                    "hourlyRateMax": "50",
                    "subcategory": "Web Programming",
                    "status": "Working",
                    "timeLeft": "Closed",
                    "jobURL": "https:\/\/elance.com\/j\/hourly-php-project\/30561771\/"
                }
            },
            "portfolio": {
                "0": {
                    "url": "/media/images/spacer.gif",
                    "title": "[MS-ASAIRS]",
                    "description": "ActiveSync AirSyncBase Namespace Protocol Specification",
                    "tags": "activesync xml devices iphone android",
                    "websiteurl": "http://msdn.microsoft.com/en-us/library/dd299454(v=exchg.80).aspx",
                    "fullurl": "https://elance.com/samples/ms-asairs-activesync-xml-devices-iphone-android/40202562/"
                }
            },
            "testimonials": {
                "0": {
                    "buyerName": "employer01",
                    "buyerProfileURL": "https://elance.com/e/employer01/",
                    "comments": "Excellent job!!"
                }
            },
            "timezoneData": {
                "name": "America\/New_York",
                "gmt_offset": "-05:00",
                "city": "Elance (ET)"
            }
        }
    }
}

VI. Error Codes

Error Description
E_USER_SELLPROFILE_NOT_EXIST A contractor profile does not exist for this user.

For a list of additional error codes that can be thrown by this method, see Common API Error Codes.