The jobs/{jobId} method returns detailed information of a specific job. It does not obsolete a specific method call in Version 1 of the API.

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

tableofcontents_number_textPreconditions

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_textURL Parameters

The following parameters are included in the URL path for this method.

Parameter Description
jobId The unique ID, assigned by Elance, to the job for which the client is requesting detailed information.

tableofcontents_number_textOptional Query String Parameters

This method defines no query string parameters.

tableofcontents_number_textResponse Data Description

Property Data Type Description
jobData JobData object An object representing all of the essential information belonging to a job.

tableofcontents_number_textJobData Object Data Description

Property Data Type Description
jobId integer The unique ID of the job, as supplied in the jobId URL parameter.
name string The one-line description given to the job by the employer.
description string A long description of the job and what it entails.
budget string A text string representing the range of acceptable bids, as set by the employer when the job was created. This may either be a fixed price range or a range for hourly payment, depending on the job type. This string is meant for display only, and may change in future releases.
numProposals integer The number of bids and plans for project execution that have been submitted by potential contractors.
postedDate date The month, day and year on which the job was submitted to Elance.
startDate date The month, day and year on which the project is expected to begin.
endDate date The date when bidding for this job ends, in the format DD-MON-YY.
clientUserId integer The unique integer ID assigned to the employer on Elance.
clientName string The individual or corporate name of the employer.
clientImageURL string The URL resource pointer to the picture representing the employer, such as a photograph or a logo.
clientCountry string The employer's country, returned as the full name of the nation.
clientCountryCode string The alpha-2 country code for the employer's country of residence, as specified by ISO 3166-1.
isHourly boolean (JSON true or false) True if the job is paid on an hourly basis; otherwise, false.
isWorkview boolean True if the job utilizes the Workview™ system for tracking work hours; otherwise, false.
isEscrow boolean (JSON true or false) True if the Elance Escrow service is being used for payment processing; otherwise, false.
category string The text representing the type of work represented by this project, as chosen by the employer.
subcategory string The label that further specifies the category of work to be performed.
phase integer (Enumeration) A value indicating the current state of the project, such as whether it is open, in progress, or complete. See Phase Enumeration for valid values.
isAwarded boolean True if this job has been given to a contractor; otherwise, false.
jobURL string The full path to the job listing on elance.com.

tableofcontents_number_textRequest/Response Examples in JSON

tableofcontents_number_textRequesting Job Details

tableofcontents_number_textRequest

The following URL requests the details for the job with a job ID of 27614704.

https://elance.com/api2/jobs/27614704?access_token=4eb1de8bf06b10210e000005|3680366|QO8279hJpwYYQ-bdjpt7BQ

tableofcontents_number_textResponse

{
  "api": "jobs/27614902",
  "rcode": 1,
  "data": {
    "jobData": {
      "jobId": "27614902",
      "name": "PHP Programming for Payment Module",
      "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis lacinia mi ut nunc varius cursus. Morbi eget neque mauris. Etiam ac mauris nec enim lobortis ultricies sit amet ac ipsum. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi suscipit congue massa vitae aliquet. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Cras vel pharetra leo. In est nulla, fringilla eget pulvinar eu, vulputate eget diam. Vestibulum scelerisque quam id nisi euismod sed auctor metus rutrum. Nullam sagittis urna id mi aliquam quis suscipit ipsum rutrum.",
      "budget": " $5,000 - $10,000",
      "numProposals": "1",
      "postedDate": "26-DEC-11",
      "startDate": "26-DEC-11",
      "endDate": "27-DEC-11",
      "clientUserId": "3680366",
      "clientName": "employer01",
      "clientImageURL": "https://elance.com/media/images/4.0/no-photo-64x80.jpg",
      "clientCountry": "United States",
      "clientCountryCode": "US",
      "clientRating": 3,
      "isHourly": true,
      "isWorkview": true,
      "isEscrow": false,
      "isW9Required": true,
      "isWatched": false,
      "category": "IT & Programming",
      "subcategory": "Web Programming",
      "phase": "2",
      "isAwarded": "Y",
      "numNewProposals": "0",
      "skillTags": ".NET, ADO.NET, AJAX, PHP, BlackBerry",
      "groupTags": "",
      "location": "Anywhere",
      "start": "Immediately",
      "highAmount": "1534.4",
      "lowAmount": "1534.4",
      "averageAmount": "1534.4",
      "jobURL": "https://elance.com/j/php-programming-payment-module/27614902/"
    }
  }
}

tableofcontents_number_textError Codes

Error Code Description
E_WORKROOM_INVALID_JOB The specified job ID is either not valid (i.e., not a job ID), or the currently logged in user does not have access to the specified job.

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