The manage/getMyProviders method is an Elance Developer API Manage method that provides a logged-in user on the Elance system with the list of providers they are currently employing.

group/getMyProviders is an authenticated method. It requires a Developer API key and an OAuth Consumer Secret, both issued by Elance. It is invoked using an HTTP or HTTPS GET request. For more details on the OAuth authentication protocol, see Using OAuth with Authenticated Methods.

This method does not support the JSONP response format.

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

tableofcontents_number_textOptional Query String Parameters

Parameter Description
bidId The unique integer ID assigned to a bid. If included, only the provider associated with that workroom is returned.
rpp The number of results requested per page. The default is 20. If more than 25 are requested, only 25 results are included in the response.
page The page number of results to return, numbered beginning from 1. The default is 1. If this number is greater than the number of total pages (as expressed in the response by totalPages), the response contains zero results.

tableofcontents_number_textResponse Data Description

For JSON responses, unless otherwise specified, 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.

Property Data Type Description
jobName string The name of the job associated with the bidId. Only returned if bidId is specified in the request.
totalResults integer The total number of records returned by this command across all pages.
totalPages integer (JSON number) The number of pages available for this request.
page integer (JSON number) The current page of data returned in the response.
numResults integer (JSON number) The number of records returned in the current page of data.
agents array of agent (see below A list of Agents.

tableofcontents_number_textagent Data

Property Data Type Description
screenData screenData The provider's essential information, including the details of the bid submitted to the client.
isOnTracker boolean (JSON true or false) Whether the provider is currently logging time for this project on Tracker.
hours decimal (JSON number) The total number of hours logged on this project.
hoursToday decimal (JSON number) The number of hours logged on this project within the current calendar day.

tableofcontents_number_textRequest/Response Examples in JSON

tableofcontents_number_textRetrieving a List of Providers

The following HTTP GET request retrieves the list of all providers for the currently logged in user. The HTTP headers for the GET request are shown below. (NOTE: Elance recommends that developers access OAuth APIs using one of the many publicly available libraries.)

tableofcontents_number_textRequest

GET /api/manage/getMyProviders HTTP/1.1
User-Agent: anyMeta/OAuth 1.0 - ($LastChangedRevision: 134 $)
Host: api.elance.com
Accept: */*
Authorization: OAuth realm="",oauth_signature_method="HMAC-SHA1",oauth_signature="2EhQGKiaw8fh90%2FNSu%2Fiv0znsP8%3D",oauth_nonce="4c8bc12f4271a",oauth_timestamp="1284227375",oauth_token="988078256-1425962-1425962-76.104.194-fd76b324028bef6-%2A",oauth_consumer_key="8dfc476b57fee5b7dc08cc0f1d5a0fcdab409b3c",oauth_version="1.0"

tableofcontents_number_textResponse

{
  "api": "manage\/getMyProviders",
  "apiVersion": 1,
  "rcode": 1,
  "data": {
    "totalResults": "2",
    "totalPages": 1,
    "page": 1,
    "numResults": 2,
    "agents": {
      "0": {
        "screenData": {
          "timestamp": 1278439885,
          "userId": "1916562",
          "userName": "OliviaT",
          "companyName": "Olivia Tremor",
          "logoURL": "http:\/\/www.elance.com\/uploads3\/F9\/BD\/19971577\/1354687.jpg",
          "numComments": 0,
          "bidId": "19806476",
          "bidData": {
            "bidId": "19806476",
            "jobId": "19806475",
            "jobName": "Upgrade existing Web e-commerce site to PHP5",
            "userType": "CLIENT",
            "clientName": "Ichiban Industries",
            "clientImageURL": "http:\/\/www.elance.com\/media\/images\/4.0\/no-photo-featured-icon.jpg",
            "clientCountry": "United States",
            "clientCountryCode": "US",
            "clientCity": "Sunnyvale",
            "providerName": "Kimberly Daugherty",
            "providerImageURL": "http:\/\/www.elance.com\/uploads3\/F9\/BD\/19971577\/1354687.jpg",
            "providerCountry": "United States",
            "providerCountryCode": "US",
            "providerCity": "Round Rock",
            "phase": "5",
            "status": "Working",
            "isHourly": false,
            "isSponsored": false,
            "isPreBid": true,
            "bidAmount": "1000",
            "hoursPerWeek": "0",
            "duration": ""
          },
          "date": "06-JUL-10"
        },
        "isOnTracker": false,
        "hours": 0,
        "hoursToday": 0
      }
      "1": {
        "screenData": {
          "timestamp": 1278439885,
          "userId": "1916562",
          "userName": "providerUno",
          "companyName": "Provider Uno",
          "logoURL": "http:\/\/www.elance.com\/uploads3\/F9\/BD\/19971577\/1354687.jpg",
          "numComments": 0,
          "bidId": "19806476",
          "bidData": {
            "bidId": "19806476",
            "jobId": "19806475",
            "jobName": "mySql DBA needd URGENTLY!",
            "userType": "CLIENT",
            "clientName": "MegaCorp Incorporated",
            "clientImageURL": "http:\/\/www.elance.com\/media\/images\/4.0\/no-photo-featured-icon.jpg",
            "clientCountry": "United States",
            "clientCountryCode": "US",
            "clientCity": "Sunnyvale",
            "providerName": "Provider Uno",
            "providerImageURL": "http:\/\/www.elance.com\/uploads3\/F9\/BD\/19971577\/1354687.jpg",
            "providerCountry": "United States",
            "providerCountryCode": "US",
            "providerCity": "Los Angeles",
            "phase": "5",
            "status": "Working",
            "isHourly": false,
            "isSponsored": false,
            "isPreBid": false,
            "bidAmount": "1875",
            "hoursPerWeek": "0",
            "duration": ""
          },
          "date": "06-JUL-10"
        },
        "isOnTracker": false,
        "hours": 0,
        "hoursToday": 0
      }
    }
  }
} 

tableofcontents_number_textError Codes

For a list of possible errors, see Common API Error Codes. The format of error responses is specified in the Getting Started page.