GET /milestones/:milestone_id
The following macros are not currently supported in the header:
  • style

GET /milestones/:milestone_id

Resource URL

Returns a milestone identified by milestone id.

GET /milestones/:milestone_id

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

 A unique id assigned to the milestone

title

string

 The milestone's title

description

string

 

standing

string

 e.g, 'pending', 'active', 'paused', 'complete', 'inactive'

status

unsigned int or object

 Returns the milestone's status id or object if you use parenthesis.

ordering

unsigned int

 

parent

unsigned int

 A unique id assigned to the milestones parent milestone (if one exists).

date_created

unsigned int

 Unix timestamp for the time the milestone was created.

date_modified

unsigned int

 

date_started

unsigned int

 

date_commenced

unsigned int

 

date_completed

unsigned int

 

date_due

unsigned int

 

job

unsigned int or object

Returns the milestones job id or object if you use parenthesis. e.g, job()

manager

unsigned int or object

Returns the milestones manager's staff id or object if you use parenthesis. e.g, manager()

rate

int or object

Returns the milestones rate id or object if you use parenthesis.

rate_charged

number

Rate charged for the milestone. Please note that if rate_id (_fields=rate) is -1, rate charged will always be zero

object_budget

unsigned int

Returns the object's budget unique id if one exists

object_budget()

object

Returns the object's budget object if one exists. For more information on optional object fields, please see: GET object_budgets/:object_budget_id

 

Fields that can be object indicate the field can be requested as a resource. For example.

GET /milestones/1.json?_fields=job

would return the job's id. Where as,

GET /milestones/1.json?_fields=job()

would return the jobs object, including any optional fields or objects within the parenthesis.