The profiles/{nameOrId} method requests details for the specified contractor.

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


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

tableofcontents_number_textRequired URL Parameters

Parameter Description
nameOrId Either the unique user ID of a contractor on the Elance system, or the username of a contractor.

tableofcontents_number_textOptional 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.

tableofcontents_number_textResponse Data Description

The response data for this method is the same as the response for the profiles/my method.

tableofcontents_number_textRequest/Response Examples in JSON

tableofcontents_number_textRequesting a User Profile

The following URL requests the user profile for the contractor whose username is testuser03.



    "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"
            "skillsCount": 0,
            "portfolioCount": 0,
            "privateEarnings": false,
            "earnings6Months": null,
            "feedback6Months": null,
            "posFeedback6Months": null,
            "avgFeedbackScore6Months": "0.0",
            "earnings12Months": null,
            "feedback12Months": null,
            "jobs12Months": null,
            "posFeedback12Months": null,
            "avgFeedbackScore12Months": "0.0",
            "elanceLevel": null,
            "category": "All Categories",
            "userCategories": [{
                "id": "10183",
                "name": "IT & Programming"
            "logo": "",
            "providerProfileURL": "",
            "providerJobHistoryURL": "",
            "earnings": null,
            "feedback": null,
            "posFeedback": null,
            "avgFeedbackScore": null,
            "clients6Months": null,
            "clients": null,
            "RepeatClients": null,
            "RepeatClients6Months": null,
            "RepeatClients12Months": null,
            "RepeatClientsPct": 0,
            "RepeatClientsPct6Months": 0,
            "RepeatClientsPct12Months": 0,
            "jobs6Months": null,
            "jobs": null,
            "milestones6Months": null,
            "milestones": null,
            "hoursWorked6Months": null,
            "hoursWorked": null,
            "earningsPerClient": 0,
            "earningsPerClient6Months": 0,
            "earningsPerClient12Months": 0,
            "clients12Months": null,
            "milestones12Months": null,
            "hoursWorked12Months": null,
            "endorsement": "N/A",
            "endorsement6Months": "N/A",
            "endorsement12Months": "N/A",
            "latestJobs": {},
            "portfolio": {},
            "testimonials": {},
            "timezoneData": {
                "name": "America/New_York",
                "gmt_offset": "-05:00",
                "city": "Elance (ET)"

tableofcontents_number_textError Codes

Error Description
E_USER_NAME_DOES_NOT_EXIST The username specified by the nameOrId parameter does not correspond to a valid user.
E_USER_DOES_NOT_EXIST The user ID specified by the nameOrId parameter does not correspond to a valid user.
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.