Job_requests
A request for Wonoloers to perform a Job

A Job Request represents a Requestor’s desire for Wonoloers to perform a Job. e.g. “I need 12 people at noon tomorrow to stack boxes.”

States

Job Requests progress through a series of states. Generally speaking, the state of a Job Request is determined by the states of the Jobs attached to it. The possible Job Request states are:

  • draft the Job Request has not yet been posted and may be incomplete.

  • unassigned the Job Request has not yet been posted so is not visible to Wonoloers. However, any Preferred Wonoloers are notified during this time, if specified.

  • posted the Job Request is acceptable by any qualified Wonoloer. During this time, qualified Wonoloers will be ranked and notified.

  • filled all of the Job Request’s slots are filled.

  • in_progress the Job Request start time has passed and at least one Wonoloer has started working.

  • completed all Wonoloers have completed work for this Job Request (i.e. all Jobs attached to this Job Request have a state of completed).

  • approved all Jobs attached to this Job Request are approved.

  • cancelled the Job Request is cancelled. All Jobs attached to this Job Request will also be cancelled.

  • unfilled the Job Request start time has passed but none of the slots was filled.

Supported Formats

json
>>>

Returns a list of Job Requests, optionally paginated. Note: the maximum number returned per page in any case is 50.

Supported Formats

json

Errors

Code Description
401 Unauthorized

Examples

curl -v -d "token=HdgXqxYWd5tTdyabzfzo" http://api.wonolo.com/api_v2/job_requests
curl -v -d "token=HdgXqxYWd5tTdyabzfzo" http://api.wonolo.com/api_v2/job_requests?page=10&per=25

Params

Param name Description
token
required

Token obtained from /authorize

Validations:

  • Must be a String
page
optional

The page number to start from

Validations:

  • Must be a Integer
per
optional

The size of the page

Validations:

  • Must be a Integer
state
optional

Filter Job Requests by state

Validations:

  • Must be a String
company_id
optional

Filter Job Requests by Company ID

Validations:

  • Must be a String
multi_day_job_request_id
optional

Filter Job Requests by the Multi-Day Job Request they relate to

Validations:

  • Must be a Integer
classification
optional

Filter Job Requests by their tax classification

Validations:

  • Must be one of: w2, 1099.
w2_hourly_rate
optional

Filter Job Requests by their W2 hourly rate

Validations:

  • Must be a Float
updated_before
optional

Filter Job Requests by those that were last updated before provided DateTime

Validations:

  • Must be a DateTime
updated_after
optional

Filter Job Requests by those that were last updated after provided DateTime

Validations:

  • Must be a DateTime
>>>

GET /api_v2/job_requests/:id
Get a specific JobRequest

Supported Formats

json

Params

Param name Description
token
required

Token obtained from /authorize

Validations:

  • Must be a String
id
required

ID of Job Request

Validations:

  • Must be a Integer
>>>

GET /api_v2/job_requests/:id/rankings
List the Wonoloers that are ranked for this JobRequest

Returns details of the Wonoloers that were ranked for this JobRequest, in ranked order.

Supported Formats

json

Errors

Code Description
403 Forbidden - if you have Public Pool access only

Params

Param name Description
token
required

Token obtained from /authorize

Validations:

  • Must be a String
id
required

ID of Job Request

Validations:

  • Must be a Integer