The following macros are not currently supported in the header:
- style
GET /jobs/:id
Resource URL
Returns a specific job object.
GET /jobs/:id
Parameters
Table of allowed parameters.
_fields | partial string | Allows you to specify optional fields and linked objects to include in the response. |
---|---|---|
_filters | partial string | You can filter jobs using this parameter. |
Handling the response
Below is a table of available response fields and objects that are returned within the response object of the returned object. The optional fields and objects can be requested in the _fields
 parameter; see included examples. Underlined values are default.
id | unsigned int | Unique id assigned to the job |
---|---|---|
title | string | Â |
against | string | Resource endpoint for the object the job is against. For example, /companies/12 |
date_created | unix timestamp | Â |
date_modified | unix timestamp | Â |
date_started | unix timestamp | Â |
date_due | unix timestamp | Â |
date_completed | unix_timestamp | Â |
standing | string | e.g, pending, active, inactive or complete. |
paused | unsigned int | Â |
rate_charged | decimal | Â |
type | unsigned int or object | Contains the job's type id or if using parenthesis, the job's rate object. |
rate | unsigned int or object | Job's rate id or object. |
status | unsigned int or object | Job's status id or object. |
manager | unsigned int or object | Job's manager (staff) id or object. |
modified_by | unsigned int or object | The staff id or object of the last user to modify the job. |
company | unsigned int or object | Job's company id or object. |
against_id | unsigned int | The id of the object the job is against. E.g, 42 |
against_type | string | The name of the object the job is against. E.g, companies. |
NEW object_budget | Object | The budget object for job. |
NEW affiliation | Object | Â |
NEW date_started | unix timestamp | Â |
NEW date_last_interacted | unix timestamp | Â |
NEW breadcrumbs | Array | Â |
Â
Fields that can be object indicate the field can be requested as a resource. For example.
GET /jobs/1.json?_fields=manager
would return the manager's staff id. Where as,
GET /jobs/1.json?_fields=manager()
would return the manager's staff object, including any optional fields or objects within the parenthesis.