Last 7 days, UTC

Average Latency
35ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
OAuth 1.0a Authentication Show OAuth URLs - Show Curl Example

Authentication
Description
Parameter
String

The consumer key given to you by the API provider.

Consumer Key

Required

String

The consumer secret given to you by the API provider.

Consumer Secret

Required

String

A space-delimited string of access scopes.

Scope

Optional

Authenticate

Please set the callback URL to: http://guardian.mashape.com/callback

Job Profile

HTTP 200 : Job Profile GET/profiles/v1/jobs/{job_key}.{format}
Job Profile Model
						<profile>
  <engagement_weeks>Less than 1 month</engagement_weeks>
  <op_reason/>
  <op_comm_status>Active</op_comm_status>
  <op_low_hourly_rate_active_interviewees/>
  <job_category_level_two>Mobile Apps</job_category_level_two>
  <op_is_viewable>1</op_is_viewable>
  <engagement_related>4</engagement_related>
  <op_description>
Hello, We need a social network client app for iPhone/iPad to be developed. It should support Facebook, Twitter and Linked-In. It should provide the ability to: - read and send messages; - see all the updates; - comment on others' posts; - repost others' posts; - “like” smth (for Facebook); - post to all the 3 social networks simultaneously. Could you, please, provide us with the basic estimate of man-hours needed to develop such kind of app (including programming and design)? How many hours will UI design works take? Also, what will be the hourly rate for this job? Thank you in advance. We are waiting for your proposals. Regards,
  </op_description>
  <op_pref_fb_score>0</op_pref_fb_score>
  <candidates_total_active>0</candidates_total_active>
  <op_low_bid_active_interviewees/>
  <op_job_expiration>January 18, 2012</op_job_expiration>
  <ui_job_profile_access>public</ui_job_profile_access>
  <op_avg_hourly_rate_active/>
  <op_pref_test>0</op_pref_test>
  <op_tot_charge>0</op_tot_charge>
  <op_pref_test_name/>
  <op_adjusted_score>0</op_adjusted_score>
  <job_category_level_one>Software Development</job_category_level_one>
  <op_pref_hourly_rate_max>0</op_pref_hourly_rate_max>
  <op_cancel_ts/>
  <op_high_hourly_rate_active_interviewees/>
  <op_low_hourly_rate_interviewees/>
  <op_tot_cand_prof>0</op_tot_cand_prof>
  <op_is_validnonprivate>1</op_is_validnonprivate>
  <op_time_posted>09:41:27</op_time_posted>
  <timezone>Russia (UTC+06)</timezone>
  <op_eng_type>1</op_eng_type>
  <op_tot_feedback>0</op_tot_feedback>
  <amount/>
  <op_logo/>
  <op_is_console_viewable>1</op_is_console_viewable>
  <op_num_of_pending_invites>0</op_num_of_pending_invites>
  <op_avg_hourly_rate_active_interviewees/>
  <op_high_hourly_rate_active/>
  <ui_opening_status>Active</ui_opening_status>
  <op_contract_date>December 18, 2011</op_contract_date>
  <op_last_buyer_activity>December 19, 2011</op_last_buyer_activity>
  <op_low_hourly_rate_active/>
  <op_pref_hours_per_week/>
  <hours_per_week>40</hours_per_week>
  <op_date_created>December 19, 2011</op_date_created>
  <op_tot_cand_client>0</op_tot_cand_client>
  <op_avg_bid_all/>
  <version>1</version>
  <op_engagement>Full-time - 30+ hrs/week</op_engagement>
  <op_pref_hourly_rate_min>0</op_pref_hourly_rate_min>
  <offers_total>0</offers_total>
  <date_posted>December 19, 2011</date_posted>
  <op_lowhigh_bid_interviewees/>
  <op_tot_jobs_open>17</op_tot_jobs_open>
  <op_tot_jobs_filled>0</op_tot_jobs_filled>
  <op_tot_jobs_posted>17</op_tot_jobs_posted>
  <op_low_bid_all/>
  <op_high_bid_interviewees/>
  <op_tot_hours>0</op_tot_hours>
  <op_end_date>December 31, 2037</op_end_date>
  <op_low_hourly_rate_all/>
  <op_private_rating_active/>
  <op_tot_hr_asgs>0</op_tot_hr_asgs>
  <op_tot_new_cond>0</op_tot_new_cond>
  <op_job_category_seo>Mobile Development Jobs</op_job_category_seo>
  <op_pref_group_recno/>
  <op_high_hourly_rate_interviewees/>
  <op_tot_act_asgs>0</op_tot_act_asgs>
  <op_pref_location/>
  <op_high_bid_all/>
  <offers_total_open>0</offers_total_open>
  <op_tot_cand>0</op_tot_cand>
  <op_pref_odesk_hours>0</op_pref_odesk_hours>
  <op_state/>
  <op_cny_show_in_profile/>
  <search_status>Open</search_status>
  <op_pref_english_skill>0</op_pref_english_skill>
  <op_skill/>
  <op_is_searchable>1</op_is_searchable>
  <assignments/>
<buyer_model>
</buyer_model>
  <op_title>A social network client app for iPhone/iPad</op_title>
  <op_start_date>December 19, 2011</op_start_date>
  <ciphertext>~~05d405f2d5b8eb27</ciphertext>
  <op_tot_asgs>0</op_tot_asgs>
  <op_cny_suspended/>
<op_required_skills_model>
</op_required_skills_model>
  <op_charge_last30days>0</op_charge_last30days>
  <op_is_hidden/>
  <op_attached_doc/>
  <op_cny_description/>
  <op_cny_summary/>
  <op_country>Russia</op_country>
  <op_tot_fp_asgs>0</op_tot_fp_asgs>
  <op_avg_bid_interviewees/>
  <op_ui_profile_access>Public</op_ui_profile_access>
  <interviewees_total_active>0</interviewees_total_active>
  <op_avg_hourly_rate_interviewees/>
  <company_ref>468330</company_ref>
  <op_hours_last30days>0</op_hours_last30days>
  <op_desc_digest>
Hello, We need a social network client app for iPhone/iPad to be developed. It should support Facebook, Twitter and Linked-In. It should provide the ability to: - read and send messages; - see all the updates; - comment on others' posts; - repost others' posts; - “like” smth (for Facebook); - post to all the 3 social networks simultaneously. Could you, please, provide us with the basic estimate of man-hours needed to develop such kind of app (including programming and design)? How many hours w...
  </op_desc_digest>
  <op_time_created>09:41:27</op_time_created>
  <op_high_bid_active/>
  <op_tot_rej>0</op_tot_rej>
  <op_high_bid_active_interviewees/>
  <op_avg_bid_active/>
  <op_ctime>1324287687000</op_ctime>
  <op_recno>200512970</op_recno>
  <op_est_duration>3</op_est_duration>
  <job_type>Hourly</job_type>
<op_other_jobs>
</op_other_jobs>
  <op_avg_bid_active_interviewees/>
  <op_high_hourly_rate_all/>
  <op_timezone>UTC+06:00 Omsk, Novosibirsk</op_timezone>
  <op_low_bid_active/>
  <op_avg_hourly_rate_all/>
  <op_pref_has_portfolio>0</op_pref_has_portfolio>
  <op_active>1</op_active>
  <op_city/>
  <candidates/>
  <op_required_skills_tooltip/>
</profile>						
Get Job Profile

gets a specific job profile


Test console
Description
Parameter
number

The job key or a list of keys, separated by ";", number of keys per request is limited by 20. You can access profile by job recno, in that case you can't specify a list of jobs, only one profile per request is available.
Example: 12345

job_key

Required

string

formation of response.
Example: xml, json

format

Required

  • string – Bad Response

    HTTP 400

Jobs HR API

HTTP 200 : binary DELETE/hr/v2/jobs/{job_reference}.{format}
Cancel the Job

cancel a specific job with parameters


Test console
Description
Parameter
number

Job reference ID
Example: 12345

job_reference

Required

string

formation of response
Example: xml, json

format

Required

number

The reason code to cancel the job; Possible values are: 67 - Accidental opening creation 51 - All positions filled 49 - Filled by alternate source 41 - Project was cancelled 34 - No developer for requested skills
Example: 67, 51, 49, 41, 34

reason_code

Required

  • string – Forbidden

    HTTP 403
HTTP 200 : Job Object GET/hr/v2/jobs.{format}
Job Object Model
						[{
  "visibility": "public",
  "buyer_company__reference": "231755",
  "buyer_team__reference": "231755",
  "created_time": "1349573665000",
  "duration": "7",
  "description": "I have osCommerce  site need to improve check out prosses \nX press paypal and google wallet \nintegration\n\nlooking to make inverment look as wall at the site \n\nthanks",
  "buyer_company__name": "MItech",
  "subcategory": "Ecommerce",
  "job_type": "hourly",
  "end_date": "",
  "buyer_team__id": "Mitech-Security",
  "title": "osCommerce Website need checkout improvments",
  "created_by": "mwiegler",
  "status": "open",
  "budget": "",
  "public_url": "https://www.odesk.com/jobs/~0114ee1cf4b7f21d0e",
  "reference": "201713758",
  "num_candidates": "18",
  "filled_date": "",
  "num_new_candidates": "14",
  "start_date": "1349568000000",
  "num_active_candidates": "17",
  "last_candidacy_access_time": "",
  "buyer_team__name": "MItech",
  "cancelled_date": ""
}]						
Get My Jobs

Returns all jobs that a user has manage_recruiting access to. This API call can be used to find the reference ID of a specific job.


Test console
Description
Parameter
string

formation of response
Example: xml, json

format

Required

number

The buyer's team reference ID
Example: 34567

buyer_team__reference

Required

number

wether to include info about sub teams
Example: <0|1>

include_sub_teams

Optional

number

The user ID
Example: 1234

created_by

Optional

string

Status of Job
Example: open

status

Optional

string

Filter from time
Example: 2008-09-09 00:00:05

created_time_from

Optional

string

Filter to time
Example: 2009-01-20 11:59:55

created_time_to

Optional

string

Pagination, formed as $offset;$count
Example: 20;10

page

Optional

string

Sorting
Example: created_time

order_by

Optional

  • – Unathorized in case of: user not authorized

    HTTP 401
  • – Forbidden in case of: the operation is not authorized

    HTTP 403
HTTP 200 : Job Object GET/hr/v2/jobs/{job_reference}.{format}
Job Object Model
						{
  "visibility": "public",
  "buyer_company__reference": "231755",
  "buyer_team__reference": "231755",
  "created_time": "1349573665000",
  "duration": "7",
  "description": "I have osCommerce  site need to improve check out prosses \nX press paypal and google wallet \nintegration\n\nlooking to make inverment look as wall at the site \n\nthanks",
  "buyer_company__name": "MItech",
  "subcategory": "Ecommerce",
  "job_type": "hourly",
  "end_date": "",
  "buyer_team__id": "Mitech-Security",
  "title": "osCommerce Website need checkout improvments",
  "created_by": "mwiegler",
  "status": "open",
  "budget": "",
  "public_url": "https://www.odesk.com/jobs/~0114ee1cf4b7f21d0e",
  "reference": "201713758",
  "num_candidates": "18",
  "filled_date": "",
  "num_new_candidates": "14",
  "start_date": "1349568000000",
  "num_active_candidates": "17",
  "last_candidacy_access_time": "",
  "buyer_team__name": "MItech",
  "cancelled_date": ""
}						
Get Specific Job

Returns the complete job object for the referenced job, this is only available to users with manage_recruiting permissions within the team that the job is posted in.


Test console
Description
Parameter
number

Job reference ID
Example: 12345

job_reference

Required

string

formation of response
Example: xml, json

format

Required

  • – Unathorized in case of: user not authorized

    HTTP 401
  • – Forbidden in case of: the operation is not authorized

    HTTP 403
  • – Bad Request in case of: wrongly requested data

    HTTP 400
HTTP 200 : Invite Return POST/hr/v1/jobs/{job_reference}/candidates.{format}
Invite Return Module
						<response>
    <auth_user/>
    <server_time/>
    <message>
        OK
    </message>
  </response>						
Invite to interview

Sends invitation to a specific user(s)


Test console
Description
Parameter
number

Job reference ID
Example: 12345

job_reference

Required

string

formation of response
Example: xml, json

format

Required

string

Unique contractor's key
Example: ~~677961dcd7f65c05

profile_key

Required

number

Developer's unique reference ID. Use it if no profile_key available
Example: 12345

provider__reference

Required

string

Text of cover letter
Example: text string

cover

Required

  • string – Forbidden

    HTTP 403
HTTP 200 : Post Return POST/hr/v2/jobs.{format}
Post Return Model
						<response>
    <auth_user/>
    <server_time/>
    <job>
        <reference>1234</reference>
    </job>
  </response>						
Post a Job

Posts one job with required parameters


Test console
Description
Parameter
string

formation of response
Example: xml, json

format

Required

number

Reference ID of the buyer team that is posting the job
Example: 34567

buyer_team__reference

Required

string

Title of the Job
Example: Development of API ecosystem

title

Required

string

Type of posted job
Example: hourly, fixed-price

job_type

Required

string

The job's description
Example: A new interesting start-up requires an API ecosystem, ...

description

Required

string

The start date of the Job. If start_date is not included the job will default to starting immediately.
Example: 06-15-2011

start_date

Optional

string

The end date of the Job. Only needed if job type is 'fixed-price'
Example: 06-30-2011

end_date

Optional

string

The job's visibility
Example: public, private, odesk, invite-only

visibility

Required

number

The budget of the Job. Used for 'fixed-price' jobs only.
Example: 100

budget

Optional

number

The duration of job in hours. Used for 'hourly-jobs' only.
Example: 90

duration

Optional

string

The category of job
Example: Web Development

category

Required

string

The subcategory of job
Example: Web Programming

subcategory

Required

  • – Forbidden

    HTTP 403
HTTP 200 : binary PUT/hr/v2/jobs/{job_reference}.{format}
Update Job

updates a specific job with parameters


Test console
Description
Parameter
number

Job reference ID
Example: 12345

job_reference

Required

string

formation of response
Example: xml, json

format

Required

number

Reference ID of the buyer team that is posting the job
Example: 34567

buyer_team__reference

Required

string

Title of the Job
Example: Development of API ecosystem

title

Required

string

Type of posted job
Example: hourly, fixed-price

job_type

Optional

string

The job's description
Example: A new interesting start-up requires an API ecosystem, ...

description

Required

string

The start date of the Job. If start_date is not included the job will default to starting immediately.
Example: 06-15-2011

start_date

Optional

string

The end date of the Job. Only needed if job type is 'fixed-price'
Example: 06-30-2011

end_date

Optional

string

The job's visibility
Example: public, private, odesk, invite-only

visibility

Required

number

The budget of the Job, e.g. 100. Used for 'fixed-price' jobs only.
Example: 100

budget

Optional

number

The duration of job in hours, e.g. 90. Used for 'hourly-jobs' only.
Example: 90

duration

Optional

string

The category of job
Example: Web Development

category

Required

string

The subcategory of job
Example: Web Programming

subcategory

Required

string

The status of the job
Example: open, filled, cancelled

status

Optional

  • string – Forbidden

    HTTP 403

OTasks

HTTP 200 : binary POST/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks.{format}
Create an oTask record

New oTasks can be created using the API, when you create a new oTask you need to define a code, description and URL


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

formation of response
Example: xml, json

format

Required

string

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: username

username

Required

number

A task tracking code (This defines the task tracking code)

code

Required

string

The code's description (This should be a description about the code being added)

description

Required

string

The location where more info on the code can be found (The URL can be used to direct the user to more info about the code being entered)

url

Optional

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : binary DELETE/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/all_tasks.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks/all_tasks.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks/all_tasks.{format}
Delete All oTask records

Deletes all tasks within a company, team or assigned to a specific user.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

formation of response
Example: xml, json

format

Required

number

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: myuser

username

Required

string

A task tracking code (seperated by ";")

code

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : binary DELETE/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/{code}.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks/{code}.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks/{code}.{format}
Delete an oTask record

oTasks can be deleted using the API.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

number

The oTask code being deleted

code

Required

string

formation of response
Example: xml, json

format

Required

string

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: myuser

username

Required

number

A task tracking code (seperated by ";")

code

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : Task Return GET/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/{code1;code2;...;codeN}.{format} , https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks/{code1;code2;...;codeN}.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks/{code1;code2;...;codeN}.{format}
Task Return Model
						{
  "auth_user": "String Value",
  "server_time": "String Value",
  "tasks": [
    {
      "code": "String Value",
      "company_id": 10,
      "description": "String Value",
      "level": 10,
      "record_id": 10,
      "team_id": 10,
      "url": "String Value",
      "user_id": 10
    }
  ]
}						
Get a specific task record

return details on a specific oTask or set of oTasks, this format can be used within a company (:companyid), team (:teamid) or user (:userid)


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

The specific task codes, the list of codes should be separated with ";"
Example: 12;23;34

code1;code2;...;codeN

Required

string

formation of response
Example: xml, json

format

Required

number

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: myuser

username

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : Task Return GET/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks.{format} https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks.{format}
Task Return Model
						{
  "auth_user": "String Value",
  "server_time": "String Value",
  "tasks": [
    {
      "code": "String Value",
      "company_id": 10,
      "description": "String Value",
      "level": 10,
      "record_id": 10,
      "team_id": 10,
      "url": "String Value",
      "user_id": 10
    }
  ]
}						
List all Tasks

pull all tasks assigned within a company, team or to a specific user


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

formation of response
Example: xml, json

format

Required

number

The team ID
Example: 45678

team

Required

string

The username of the target user account.
Example: myuser

username

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : Task Return GET/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/full_list.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks/full_list.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks/full_list.{format}
Task Return Model
						{
  "auth_user": "String Value",
  "server_time": "String Value",
  "tasks": [
    {
      "code": "String Value",
      "company_id": 10,
      "description": "String Value",
      "level": 10,
      "record_id": 10,
      "team_id": 10,
      "url": "String Value",
      "user_id": 10
    }
  ]
}						
List all oTask records

returns all task records under the company


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

formation of response
Example: xml, json

format

Required

string

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: myuser

username

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : binary PUT/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/batch.{format}
Update a group of oTask records

oTasks can be updated using a CSV file via the API


Test console
Description
Parameter
number

The company's rollup ID
Example: 123

company

Required

string

formation of response
Example: xml, json

format

Required

string

CSV file (see example below)
Example: "acmeinc","","","ABC","Project ABC","https://www.acmeinc.com/project/abc"<br>"acmeinc","acmeinc:dev","b42","123","Task 123","https://www.acmeinc.com/task/123"

data

Required

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403
HTTP 200 : binary PUT/https://www.odesk.com/api/otask/v1/tasks/companies/{company}/tasks/{code}.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/tasks/{code}.{format}, https://www.odesk.com/api/otask/v1/tasks/companies/{company}/teams/{team}/users/{username}/tasks/{code}.{format}
Update an oTask record

updats using the API, the code, description and URL can be updated.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

number

The oTask code being updated

code

Required

string

formation of response
Example: xml, json

format

Required

number

The team ID
Example: 45678

team

Required

string

The username of the target user account
Example: targeteduser

username

Required

number

A task tracking code (This defines the task tracking code)

code

Required

string

The code's description (This should be a description about the code being added)

description

Required

string

The location where more info on the code can be found (The URL can be used to direct the user to more info about the code being entered)

url

Optional

  • string – Unathorized in case of: user not authorized

    HTTP 401
  • string – Forbidden in case of: No access to company No access to team

    HTTP 403

Time Reports

HTTP 200 : binary GET/https://www.odesk.com/gds/timereports/v1/companies/{company}/teams/{team}/hours, https://www.odesk.com/gds/timereports/v1/companies/{company}/teams/{team}
Generate Time Reports for a Specific Team

Time reports can be generated for a specific team, with or without detailed monetary information based on the relationship of the authorized user at the time the call is made and what information is included in the call.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

number

The team ID
Example: 34567

team

Required

string

note: format must be specified in tqx parameter, see example.
Example: json, xml, csv

format

Required

string

The Google query goes here.
Example: SELECT worked_on, provider_id, provider_name, sum(hours) WHERE worked_on >= '2009-10-01' AND worked_on <= '2009-10-31'

tq

Required

  • string – # 'access_denied' if the authenticated user is not in the given team ([team]).

    HTTP 490
  • string – # 'invalid_query' if API throws INVALID_QUERY exception.

    HTTP 491
  • string – # 'access_denied' if API throws INVALID_COMPANY|TEAM_NOT_IN_COMPANY|USER_NOT_IN_TEAM exception.

    HTTP 492
  • string – # 'other' if API throws CUSTOM_ERROR exception

    HTTP 493
HTTP 200 : binary GET/https://www.odesk.com/gds/timereports/v1/companies/{company}/agencies/{agency}
Generating Agency Specific Reports

Time reports can be generated for an agency, in order to use this API the authorized user needs staffing manager permissions to the agency.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

number

The agency ID
Example: 67890

agency

Required

string

note: format must be specified in tqx parameter, see example
Example: json, xml, csv

format

Required

string

The Google query goes here
Example: SELECT week_worked_on, assignment_team_id, provider_id, assignment_name, sum(hours), sum(earnings) WHERE worked_on > '2009-10-01' AND worked_on <= '2009-10-31

tq

Required

  • string – # 'access_denied' if the authenticated user is not in the given agency ([agency]).

    HTTP 490
  • string – # 'invalid_query' if API throws INVALID_QUERY exception.

    HTTP 491
  • string – # 'access_denied' if API throws INVALID_COMPANY|TEAM_NOT_IN_COMPANY|USER_NOT_IN_TEAM exception.

    HTTP 492
  • string – # 'other' if API throws CUSTOM_ERROR exception.

    HTTP 493
HTTP 200 : binary GET/https://www.odesk.com/gds/timereports/v1/companies/{company}
Generating Company Wide Reports

Time reports can be generated on a company-wide level. All time reports fields are supported on this level except earnings related fields. In order to access this API the authorized user needs either hiring or finance permissions to all teams within the company.


Test console
Description
Parameter
number

The company ID
Example: 12345

company

Required

string

note: format must be specified in tqx parameter, see example
Example: json, xml, csv

format

Required

string

The Google query goes here
Example: SELECT week_worked_on, assignment_team_id, sum(hours), sum(charges) WHERE worked_on > '2009-10-01' AND worked_on <= '2009-10-31'

tq

Required

  • string – # 'access_denied' if the authenticated user is not in the given company ([company]).

    HTTP 490
  • string – # 'invalid_query' if API throws INVALID_QUERY exception.

    HTTP 491
  • string – # 'access_denied' if API throws INVALID_COMPANY|NO_PERMISSIONS exception.

    HTTP 492
  • string – # 'other' if API throws CUSTOM_ERROR exception.

    HTTP 493
HTTP 200 : binary GET/https://www.odesk.com/gds/timereports/v1/providers/{provider}/hours, https://www.odesk.com/gds/timereports/v1/providers/{provider}
Generating Provider Specific Reports

This API allows callers to fetch data source of themselves. No monetary fields, such as charges or earnings, are supported. The caller of this API must be the provider himself.


Test console
Description
Parameter
number

The provider ID
Example: 68378

provider

Required

string

note: format must be specified in tqx parameter, see example
Example: json, xml, csv

format

Required

string

The Google query goes here
Example: SELECT worked_on, assignment_team_id, hours, task, memo WHERE worked_on > '2009-10-01' AND worked_on <= '2009-10-31'

tq

Required

  • string – # 'access_denied' if the authenticated user is not the provider ([provider]).

    HTTP 490
  • string – # 'invalid_query' if API throws INVALID_QUERY exception.

    HTTP 491
  • string – # 'other' if API throws CUSTOM_ERROR exception.

    HTTP 492

Consume this API completely for free!


By joining the mashape API marketplace you can start using oDesk APIs API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.