Let the platform do the work

/ForecastWorksheets/filter GET

Returns a collection of ForecastWorksheet models

Summary:

This end point is used to return the Worksheets for a user at a given timeperiod. If no timeperiod is provide it will use the default timeperiod, likewise if no user is provided, it will default to the logged in user.

Also this end points use the visibility requirements set forth by the application, that if the records being requested belong to you, you will get the draft version, If the worksheet is not yours, you will only see the committed version.

Query Parameters:

Param Description Optional
filter What you want to filter on Optional
type Which type to return, currently the ones that are supported are, opportunity and product Optional

Possible Errors

Error Description
412 - Invalid Parameter When the passed in timeperiod and/or user can not be found
403 - Not Authorized If you are not a manager, but you are tyring to view another sales rep forecast worksheet, you will receive a 403 Not Authorized Error

Url Example:

/rest/v10/ForecastWorksheets/:timeperiod_id/:user_id { "filter":[ {"assigned_user_id" : "seed_jim_id"}, {"timeperiod_id":"e546185a-5889-ea75-84c8-511178d1a5ba"} ], }

Output Example:

{ "next_offset": -1, "records": [ { "id": "ad3908c7-83a3-f360-c223-51117844c208", "name": "Grow-Fast Inc - 1000 units", "date_entered": "2013-02-05T21:22:00+00:00", "date_modified": "2013-02-05T21:22:00+00:00", "modified_user_id": "1", "modified_by_name": "Administrator", "created_by": "1", "created_by_name": "Administrator", "description": "", "img": "", "deleted": "0", "assigned_user_id": "seed_jim_id", "assigned_user_name": "Jim Brennan", "team_name": [ { "id": "East", "name": "East", "name_2": "", "primary": true } ], "parent_id": "50b90565-e748-ed77-d9d7-511178f5acae", "parent_type": "Opportunities", "account_name": "", "account_id": "", "likely_case": "75000", "best_case": "75000", "worst_case": "75000", "base_rate": "1", "currency_id": "-99", "currency_name": "", "currency_symbol": "", "date_closed": "2013-02-10", "date_closed_timestamp": "1360531443", "sales_stage": "Perception Analysis", "probability": "70", "commit_stage": "include", "draft": "1", "my_favorite": false, "_acl": { "fields": {} } }] }