The profile/getProviderProfile method is an Elance Developer API Profile method that provides access to the publicly visible portions of a provider's profile data. The data returned includes the provider's current jobs, skills, and all testimonials left by previous clients.

profile/getProviderProfile is a public method. It requires a valid Elance Developer API key, but does not require HTTP authentication. It is invoked as an HTTP GET request.

This method can return straight JSON data, or a Javascript callback. The name of the callback is specified using the jsonp query string parameter.

For more information on the format of an Elance Developer API request, see Getting Started.

tableofcontents_number_textRequired Query String Parameters

Parameter Description
userId The unique numeric ID assigned to the user by Elance. If this parameter is missing, the userName parameter must be specified.
userName The Elance on-screen name chosen by the user. If this parameter is missing, the userId parameter must be specified.
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. 

tableofcontents_number_textValid Values for catId

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

tableofcontents_number_textResponse Data Description

The result of a successful profile/getProviderProfile call is a single providerProfile object.

For JSON responses, unless otherwise noted, all parameters are returned as JSON string types. The value in the Data Type column denotes the type to which the property can safely be cast.

tableofcontents_number_textproviderProfile Object

Property Data Type Description
userId integer The provider's unique numeric ID.
userName string The provider's unique on-screen name.
businessName string The provider's business name, as displayed on the provider's profile.
tagLine string A short phrase chosen by the provider that summarizes the provider's services.
hourlyRate integer The minimum hourly rate charged by the provider. If not specified by the provider, this field is empty.
city string The primary city of the provider.
state string The primary state or province of the provider.
country string The primary country of the provider.
countryCode string The alpha-2 country code for the provider's country of residence, as specified by ISO 3166-1.
earnings6Months decimal The provider's total Elance earnings in the past six months for jobs in the specified category.
feedback6Months integer The total number of feedback reports received by the provider in the past six months for jobs in the specified category.
posFeedback6Months integer The total number of positive feedback reports received by the provider in the past six months for jobs in the specified category.
avgFeedbackScore6Months decimal The arithmetic mean of all feedback scores left in the past six months for jobs in the specified category.
earnings12Months decimal The provider's total Elance earnings in the past 12 months for jobs in the specified category.
feedback12Months integer The total number of feedback reports received by the provider in the past 12 months for jobs in the specified category.
posFeedback12Months integer The total number of positive feedback reports received by the provider in the past 12 months for jobs in the specified category.
avgFeedbackScore12Months number The arithmetic mean of all feedback scores left in the past 12 months for jobs in the specified category.
elanceLevel integer The provider's level ranking on Elance, which reflects marketing activity, completed jobs, and client reviews, relative to the specified category.
category string The type of service offered by the provider. This value will be one of the values of Category Name specified under Valid Values for catId.
logo url The URL to the provider's logo as displayed in search results. The dimensions of this image are 40px by 50px.
providerProfileURL url The URL to the provider's complete Elance profile.
earnings integer The provider's total wages accumulated since joining Elance, in US dollars.
feedback integer The number of feedback ratings left for this provider.
posFeedback integer The number of positive feedback ratings left for this provider that are higher than 4.0.
avgFeedbackScore decimal The arithmetic mean of all feedback scores.
clients6Months integer The number of clients who have hired the provider in the past six months. Includes both completed and ongoing projects.
clients integer The number of clients who have hired the provider since the provider joined Elance. Includes both completed and ongoing projects.
repeatClients integer The number of clients who have hired this provider two or more times since the provider joined Elance. Includes both completed and ongoing projects.
jobs6Months integer The number of jobs this provider has been awarded in the past six months. Includes both completed and current jobs.
jobs integer The total number of jobs this provider has been awarded since joining Elance. Includes both completed and current jobs.
milestones6Months integer The total number of job milestones the provider has successfully completed in the past six months.
milestones integer The total number of job milestones the provider has successfully completed since joining Elance.
hoursWorked6Months integer The total number of hours logged on hourly projects by this provider in the past six months.
hoursWorked integer The total number of hours logged on hourly projects by this provider since joining Elance.
earningsPerClient integer (JSON number) The arithmetic mean of how much this provider has earned from their stable of clients, in US dollars.
clients12Months integer The number of clients who have hired the provider in the past 12 months. Includes both completed and ongoing projects.
jobs12Months integer The number of jobs this provider has been awarded in the past 12 months. Includes both completed and current jobs.
milestones12Months integer The total number of job milestones the provider has successfully completed in the past six months.
hoursWorked12Months integer The total number of hours logged on hourly projects by this provider in the past 12 months.
latestJobs array of General Job Data objects, as defined below A list of the provider's last four jobs, in reverse chronological order.
skills array of Skill Data objects, as defined below A list of the provider's skills, as ordered by the provider.
testimonials array of Testimonial objects, as defined below A list of the last five testimonials left for the provider, in reverse chronological order.

tableofcontents_number_textGeneral Job Data

For a description of the types of job data available from various API methods, see Data and Method Overview.

Property Data Type Description
jobId number The unique numeric ID for this job.
name string The name of the job as chosen by the seller.
description string The seller's description of the job's requirements.
budget string The proposed budget for this job.
startDate timestamp When bidding started for this job, expressed in seconds since January 1st, 1970.
endDate timestamp When bidding will end for this job, expressed in seconds since January 1st, 1970.
category string The service category to which this job was posted.
numProposals integer The number of proposals made on this job before it was awarded to the provider.
jobURL url The URL to the full job description on the Elance Web site.

tableofcontents_number_textSkill Data

Property Data Type Description
skillId number The ID number for a standard skill. If proficiencyType is SELF-RATED, this property will be null.
name string The name of the skill.
proficiencyType enumeration (string)

Specifies how the user's proficiency was gauged. Valid values are:

SELF-RATED
TESTED

proficiency number The provider's proficiency score, on a scale from 1 to 10.
testAverage number The average score for this test obtained across all test takers. If proficiencyType is SELF-RATED, this property will be null.
testPercentile number The provider's test score ranking compared to all other test takers. If proficiencyType is SELF-RATED, this property will be null.

tableofcontents_number_textTestimonial

Property Data Type Description
buyerName string The name of the client who left this testimonial.
buyerProfileURL URL The URL to the client's profile.
comments string The client's written testimonial data.

tableofcontents_number_textRequest/Response Samples in JSON

tableofcontents_number_textObtain Profile Data

The following code example demonstrates a sample HTTP GET request for obtaining the specified profile data from Elance. It uses the curl command-line utility.

tableofcontents_number_textRequest

curl "http://api.elance.com/api/profile/getProviderProfile?&amp;catId=10184&amp;userId=350729&amp;oauth_consumer_key=8dfc476c57eee5b7dc08cc0f1d5a0fcdab409b3c"<br />

tableofcontents_number_textResponse

{
    "api": "profile\/getProviderProfile",   
    "apiVersion": 1,   
    "rcode": 1,   
    "data": {     
	    "providerProfile": {       
                       "userId": "350729",
                       "userName": "providerUno",
                       "businessName": "Provider Uno",
                       "tagLine": "For all your programming and technical writer needs!",
                       "hourlyRate": null,
                       "city": null,	
                       "state": null,
                       "country": null,
                       "countryCode": "IN",
                       "earnings6Months": "290760",
                       "feedback6Months": "6",
                       "posFeedback6Months": "6",
                       "avgFeedbackScore6Months": "0.0",
                       "earnings12Months": "807623",
                       "feedback12Months": "29",
                       "posFeedback12Months": null,
                       "avgFeedbackScore12Months": "0.0",
                       "elanceLevel": null,
                       "category": "All Services",
                       "logo": "http:\/\/www.elance.com\/uploads2\/95\/57\/17323925\/provideruno.jpg",
                       "providerProfileURL": "http:\/\/www.elance.com\/s\/provideruno\/",
                       "earnings": "5343204",
                       "feedback": "367",
                       "posFeedback": "357",
                       "avgFeedbackScore": "4.896258748",
                       "clients6Months": "93",
                       "clients": "756",
                       "RepeatClients": "123",
                       "jobs6Months": "30",
                       "jobs": "950",
                       "milestones6Months": "49",
                       "milestones": "1026",
                       "hoursWorked6Months": "290",
                       "hoursWorked": "640",
                       "earningsPerClient": 7068,                       
                       "clients12Months": "160",
                       "jobs12Months": "79",
                       "milestones12Months": "147",
                       "hoursWorked12Months": "540",   
		       "latestJobs": {         
				"0": {           
					"jobId": "9817829",           
					"name": "WordPress Installation and Configuration",           
					"description": null,           
					"budget": null,           
					"startDate": null,           
					"endDate": null,           
					"category": null,           
					"numProposals": null,           
					"jobURL": "http:\/\/www.elance.com\/job?jobid=9817829"
				},         
				"1": {           
					"jobId": "9871111",           
					"name": "Software Development Project",           
					"description": null,           
					"budget": null,           
					"startDate": null,           
					"endDate": null,           
					"category": null,           
					"numProposals": null,           
					"jobURL": "http:\/\/www.elance.com\/job?jobid=9871111"         
				},
				"2": {           
					"jobId": "9551111",           
					"name": "Graphics for New Online Soap Business",           
					"description": null,           
					"budget": null,           
					"startDate": null,           
					"endDate": null,           
					"category": null,           
					"numProposals": null,           
					"jobURL": "http:\/\/www.elance.com:7777\/job?jobid=9551111"         
				},       
				"3": {           
					"jobId": "8532222",           
					"name": "logo, stationery,etc. for medical clinics",           
					"description": null,           
					"budget": null,           
					"startDate": null,           
					"endDate": null,           
					"category": null,           
					"numProposals": null,           
					"jobURL": "http:\/\/www.elance.com\/job?jobid=8532222"         
				}       
			},       
			"skills": {         
				"0": {           
					"skillId": "109409",           
					"name": "Microsoft Office Live Web Design",           
					"proficiencyType": "SELF_ASSESSED",           
					"proficiency": "8",           
					"testAverage": null,           
					"testPercentile": null         
				},         
				"1": {           
					"skillId": null,           
					"name": "This is a Custom Skill",           
					"proficiencyType": "SELF_ASSESSED",           
					"proficiency": "8",           
					"testAverage": null,           
					"testPercentile": null         
				}, 
				// Intervening records omitted...
				"18": {           
					"skillId": "117",           
					"name": "Python 2.x",           
					"proficiencyType": "TESTED",           
					"proficiency": "9",           
					"testAverage": "62",           
					"testPercentile": "99"         
				},                
			},       
			"testimonials": {         
				"0": {           
					"buyerName": "happycustomer1",           
					"buyerProfileURL": "http:\/\/www.elance.com\/e\/customer\/",           
					"comments": "Courteous, efficient, and professional. Always a pleasure doing business with them!"         
				}, 
				/// Intervening records omitted         
				"4": {           
					"buyerName": "happycustomer2",           
					"buyerProfileURL": "http:\/\/www.elance.com\/e\/happycustomer2\/",           
					"comments": "Provider Uno live up to their name!"         
				}       
			}     
		}   
	}
}  

tableofcontents_number_textError Codes

If the Elance Developer API encounters an error in processing the request, it may return one of the error codes below. The format of error responses is specified in the Getting Started page. For a list of other common errors that can be thrown by this method, see Common API Error Codes.

Error Code Description
E_USER_NAME_DOES_NOT_EXIST The user specified by userName does not exist.
E_USER_DOES_NOT_EXIST The user specified by userId does not exist.
E_USER_SELLPROFILE_NOT_EXIST The user specified by either userName or userId does not have a provider profile.
E_USER_PROFILE_BLOCKED The user specified by either userName or userId has an expired account, or has had their profile blocked by Elance.
E_CATEGORY_NOT_EXIST The service category specified by catId does not exist.