GET /rest/v1.0/workforce-planning/v2/companies/{company_id}/people/{person_id}/reports/assignment-history

Fetches the assignment history for a specific Person, returning records of all assignments linked to them.

Servers

Path parameters

Name Type Required Description
person_id Integer Yes

Unique identifier for the person

company_id Yes

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) - Supported for backward compatibility

A proxy layer automatically handles both formats, but using the Procore company ID is preferred for consistency with other Procore APIs.

Request headers

Name Type Required Description
Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
projectName Boolean No

Whether to include the project name for each assignment.

Default value: true

start_time Boolean No

Will return the daily start time for each assignment.

Default value: true

labels Boolean No

Will return the name and UUID of the Label for each assignment.

Default value: true

cost_code Boolean No

Will return the name and UUID of the Cost Code for each assignment.

Default value: true

assignmentStart Boolean No

Whether to include the assignment start date.

Default value: true

duration Boolean No

Will return a calculated duration for each listed assignment.

Default value: true

project_number String No

Filters items by their exact project number. The query performs an exact match. Example usage: /v2/companies/{company_id}/...?project_number=BR-2024

assignmentEnd Boolean No

Whether to include the assignment end date.

Default value: true

end_time Boolean No

Will return the daily end time for each assignment.

Default value: true

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.