Get Look Ahead Data
get_look_ahead_dataRead-onlyIdempotent
Retrieve future assignments and availability details for people in a group. Filter by job titles, project numbers, or employee numbers to get customized workforce planning data.
Instructions
Fetches the Look Ahead report which provides future assignments and availability details for People within a specified Group. To span all Groups in the company, use "all" in place of {group_id}. Use this to fetch the full details of a specific Resource Planning records by its identifier. Returns a JSON object describing the requested Resource Planning records. Required parameters: company_id, group_id. Procore API: Resource Management > Resource Planning. Endpoint: GET /rest/v1.0/workforce-planning/v2/companies/{company_id}/groups/{group_id}/reports/look-ahead
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | URL path parameter — unique identifier for the company. This parameter accepts both formats: - **Recommended**: Procore company ID (integer) - Use this for new integrations - Legacy: LaborChart UUID format (uuid string... | |
| group_id | Yes | URL path parameter — unique identifier for the group | |
| jobTitleIds | No | Query string parameter — an array of UUIDs representing the Job Titles to include in the report. People with Job Titles not in this list will be excluded. | |
| assignmentCount | No | Query string parameter — the number of future assignments to return per person. | |
| projectName | No | Query string parameter — whether to include the project name for each assignment. | |
| project_number | No | Query string parameter — filters items by their exact project number. The query performs an exact match. Example usage: `/v2/companies/{company_id}/...?project_number=BR-2024` | |
| assignmentStart | No | Query string parameter — whether to include the assignment start date. | |
| assignmentEnd | No | Query string parameter — whether to include the assignment end date. | |
| availableAfterDate | No | Query string parameter — whether to include the last day a person is assigned in the future. | |
| employee_number | No | Query string parameter — filter results by the exact employee number of the Person. | |
| jobTitle | No | Query string parameter — whether to include the person's Job Title. | |
| assignmentDuration | No | Query string parameter — whether to include a calculated duration for each assignment. | |
| page | No | Page number for paginated results (default: 1) | |
| per_page | No | Number of items per page (default: 100, max: 100) |