/ForecastWorksheets/:timeperiod_id 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.

Url Parameters:

Param	Description	Optional
timeperiod_id	Show for a specific time period, defaults to the current time period if one is not passed	Optional
user_id	Show for a specific user, defaults to current user if not defined	Optional

Query Parameters:

Param	Description	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

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": {}
                }
            }]
        }