Pulling every project in the system (or every task) is a time consuming process. The picklist api provides a simple way to get a simple id+name listing of elements in the system that you may use elsewhere (eg - in time or expense entries). Take a look at the options below to see the types of simple lists BigTime's api will return.

Note that the picklist api is a 'read-only' api. To change these values, you'll need to use one of the detailed api's below (eg - project, client or task "updates"). In addition, the picklist api has been designed to return only the items that the currently logged in user is allowed to see (eg - your project list will contain ONLY the projects that this currently logged in user can view in their timesheet).

headers X-Auth-Token:{your api token} ; X-Auth-Realm: {your api realm}
HTTP GET /picklist/projects
RESULT [{id:123, name:"Allstate Corporation"}, {id:456, name:"ABC Company"}, ...]

Creating a NEW expense code.

try it

• [{"Nm": "", "Code": 0, "Desc": ""}]
• Post

Note that only the fields listed in the Update view (below) should be included in your post to this url. Any other data will be ignored. BigTime doesn't care about the order in which field data is posted, and none of the fields are case sensitive. Note that any validation errors will return a 400 error, and an invalid permission will return a 405 (eg - attempting to create an expense code when you don't have that right).

HEADERS:  X-Auth-Token:{YourAPIToken}, X-Auth-Realm:{YourFirmId}
HTTP Post:  /picklist/ExpenseCode
POST CONTENT:  {  
   "CustomFields":[  
      {  
         "Nm":Travel Expense,
         "Code":1234,
         "Desc":Expenses for everything travel related
		...
      },
      {  
         "Nm":Meal Expense,
         "Code":1233,
         "Desc":Meals provided by the firm
		...
      }, 
	  ...
   ]
}
		
You can include ANY of the Update fields below, 
		but you MUST include the required (*) fields.

HTTP RESPONSE:  (updated ExpenseCode object -- see below for details)